Skip to main content

Date Picker

The DatePicker component is a fully featured date selection component that lets you select a date, or range of dates.

info

For more details about Vuetify’s usage of DatePicker component, click DatePicker page.
For more prop explanations, click Vuetify DatePicker API page.

Props

NameDescriptionTypeDefault
darkApplies the dark theme variant to the component. You can find more information on the Material Design documentation for dark themes.booleanfalse.
dayFormatAllows you to customize the format of the day string that appears in the date table. Called with date (ISO 8601 date string) arguments.functionnull
disabledDisables interaction with the picker.booleanfalse
eventColorSets the color for event dot. It can be string (all events will have the same color) or object where attribute is the event date and value is boolean/color/array of colors for specified date or function taking date as a parameter and returning boolean/color/array of colors for that date.array - function - object - stringwarning
eventsArray of dates or object defining events or colors or function returning boolean/color/array of colors.array - function- objectnull
firstDayOfWeekSets the first day of the week, starting with 0 for Sunday.string- number0
headerDateFormatAllows you to customize the format of the month string that appears in the header of the calendar. Called with date (ISO 8601 date string) arguments.functionnull
landscapeOrients picker horizontal.booleanfalse
localeSets the locale. Accepts a string with a BCP 47 language tag.stringundefined
localeFirstDayOfYearSets the day that determines the first week of the year, starting with 0 for Sunday. For ISO 8601 this should be 4.string - number0
maxMaximum allowed date/month (ISO 8601 format).stringundefined
minMinimum allowed date/month (ISO 8601 format).stringundefined
monthFormatFormatting function used for displaying months in the months table. Called with date (ISO 8601 date string) arguments.functionnull
multipleAllow the selection of multiple dates.booleanfalse
nextIconSets the icon for next month/year button.string'$next'
noTitleHide the picker title.booleanfalse
pickerDateDisplayed year/month.stringundefined
prevIconSets the icon for previous month/year button.string'$prev'
rangeAllow the selection of date range.booleanfalse
reactiveUpdates the picker model when changing months/years automatically.booleanfalse
readonlyMakes the picker readonly (doesn’t allow to select new date).booleanfalse
scrollableAllows changing displayed month with mouse scroll.booleanfalse
selectedItemsTextText used for translating the number of selected dates when using multiple prop. Can also be customizing globally in Internationalization.string'$vuetify.datePicker.itemsSelected'
showCurrentToggles visibility of the current date/month outline or shows the provided date/month as a current.boolean - stringtrue
showWeekToggles visibility of the week numbers in the body of the calendar.booleanfalse
titleDateFormatAllows you to customize the format of the date string that appears in the title of the date picker. Called with date (ISO 8601 date string) arguments.function.null
typeDetermines the type of the picker - date for date picker, month for month picker.string'date'
weekdayFormatAllows you to customize the format of the weekday string that appears in the body of the calendar. Called with date (ISO 8601 date string) arguments.functionnull
tabindexIt determines the order of switching from one component to another with the tab key.stringundefined
valueDate picker model.array - stringundefined
visibleVisibility of DatePicker component.booleantrue

Events

NameDescription
inputThe updated bound model
changeReactive date picker emits input even when any part of the date (year/month/day) changes, but change event is emitted only when the day (for date pickers) or month (for month pickers) changes. If range prop is set, date picker emits change when both [from, to] are selected.
update:picker-dateThe .sync event for picker-date prop

Mobile Usage

Use VInlineDatePicker on mobile.

Samples Component

How do I change the language of the DatePicker?


DatePickerLocale

How do I use the DatePicker inline?


DatePickerInlineExample

How can I make certain dates selectable in DatePicker?


AllowdDates

How can I show weekends and holidays on DatePicker?


DatePicker_AllowdDates