Date/month picker

The v-date-picker is stand-alone component that can be utilized in many existing Vuetify components. It offers the user a visual representation for selecting date/month.

Utilização

Date pickers come in two orientation variations, portrait (default) and landscape. By default they are emitting input event when the day (for date picker) or month (for month picker), but with reactive prop they can update the model even after clicking year/month.

API

v-date-picker
Nome
allowed-dates
Padrão
null
Tipos
function

Components.DatePickers.

Nome
color
Padrão
undefined
Tipos
string

Components.DatePickers.

Nome
dark
Padrão
false
Tipos
boolean

Components.DatePickers.

Nome
day-format
Padrão
null
Tipos
function

Components.DatePickers.

Nome
disabled New in — v1.4
Padrão
false
Tipos
boolean

Components.DatePickers.

Nome
event-color
Padrão
warning
Tipos
array | function | object | string

Components.DatePickers.

Nome
events
Padrão
null
Tipos
array | function | object

Components.DatePickers.

Nome
first-day-of-week
Padrão
0
Tipos
string | number

Components.DatePickers.

Nome
full-width
Padrão
false
Tipos
boolean

Força largura 100%

Nome
header-color
Padrão
undefined
Tipos
string

Components.DatePickers.

Nome
header-date-format
Padrão
null
Tipos
function

Components.DatePickers.

Nome
landscape
Padrão
false
Tipos
boolean

Components.DatePickers.

Nome
light
Padrão
false
Tipos
boolean

Components.DatePickers.

Nome
locale
Padrão
'en-us'
Tipos
string

Components.DatePickers.

Nome
max
Padrão
undefined
Tipos
string

Define a largura máxima

Nome
min
Padrão
undefined
Tipos
string

Define a largura mínima

Nome
month-format
Padrão
null
Tipos
function

Components.DatePickers.

Nome
multiple New in — v1.2
Padrão
false
Tipos
boolean

Components.DatePickers.

Nome
next-icon
Padrão
'$vuetify.icons.next'
Tipos
string

Components.DatePickers.

Nome
no-title
Padrão
false
Tipos
boolean

Components.DatePickers.

Nome
picker-date
Padrão
undefined
Tipos
string

Components.DatePickers.

Nome
prev-icon
Padrão
'$vuetify.icons.prev'
Tipos
string

Components.DatePickers.

Nome
reactive
Padrão
false
Tipos
boolean

Components.DatePickers.

Nome
readonly
Padrão
false
Tipos
boolean

Components.DatePickers.

Nome
scrollable
Padrão
false
Tipos
boolean

Components.DatePickers.

Nome
show-current
Padrão
true
Tipos
boolean | string

Components.DatePickers.

Nome
show-week New in — v1.4
Padrão
false
Tipos
boolean

Components.DatePickers.

Nome
title-date-format
Padrão
null
Tipos
function

Components.DatePickers.

Nome
type
Padrão
'date'
Tipos
string

Components.DatePickers.

Nome
value
Padrão
undefined
Tipos
array | string

Controla visibilidade

Nome
weekday-format New in — v1.3
Padrão
null
Tipos
function

Components.DatePickers.

Nome
width
Padrão
290
Tipos
number | string

A largura do conteúdo

Nome
year-format
Padrão
null
Tipos
function

Components.DatePickers.

Nome
year-icon
Padrão
undefined
Tipos
string

Components.DatePickers.

Exemplos

Date pickers - Colors

Date picker colors can be set using the color and header-color props. If header-color prop is not provided header will use the color prop value.

Date pickers - In dialog and menu

When integrating a picker into a v-text-field, it is recommended to use the readonly prop. This will prevent mobile keyboards from triggering. To save vertical space, you can also hide the picker title.

Pickers expose a scoped slot that allow you to hook into save and cancel functionality. This will maintain an old value which can be replaced if the user cancels.

Date pickers - formatting date

If you need to display date in the custom format (different than YYYY-MM-DD) you need to use the formatting function.

Date pickers - formatting date using external libs

Formatting dates is possible also with external libs such as Moment.js or date-fns

Date pickers - Allowed dates

You can specify allowed dates using arrays, objects, and functions.

Date pickers - Mutiple

Date picker can now select multiple dates with the multiple prop. If using multiple then date picker expects its model to be an array.

Date pickers - Setting picker width

You can specify allowed the picker's width or make it full width.

Date pickers - birthday picker

Starting with year picker by default, resticting dates range and closing the picker menu after selecting the day make the perfect birthday picker.

Date pickers - react to displayed month/year change

You can watch the pickerDate which is the displayed month/year (depending on the picker type and active view) to perform some action when it changes.

Date pickers - Events

You can specify events using arrays, objects or functions. To change the default color of the event use event-color prop. Your events function or object can return an array of colors (material or css) in case you want to display multiple event indicators.

Date pickers - Internationalization

The date picker supports internationalization through the JavaScript Date object. Specify a BCP 47 language tag using the locale prop, and then set the first day of the week with the first-day-of-week prop.

Date pickers - icons

You can override the default icons used in the picker.

Date pickers - read only

Selecting new date could be disabled by adding readonly prop.

Date pickers - current date indicator

By default the current date is displayed using outline button - show-current prop allows you to remove the border or select different date to be displayed as the current one.

Month pickers

Month pickers come in two orientation variations, portrait (default) and landscape.

Month pickers - Colors

Month picker colors can be set using the color and header-color props. If header-color prop is not provided header will use the color prop value.

Month pickers - In dialog and menu

When integrating a picker into a v-text-field, it is recommended to use the readonly prop. This will prevent mobile keyboards from triggering. To save vertical space, you can also hide the picker title.

Pickers expose a scoped slot that allow you to hook into save and cancel functionality. This will maintain an old value which can be replaced if the user cancels.

Month pickers - Allowed months

You can specify allowed months using arrays, objects or functions.

Month pickers - Multiple

Month pickers can now select multiple months with the multiple prop. If using multiple then the month picker expects its model to be an array.

Month pickers - Setting picker width

You can specify allowed the picker's width or make it full width.

Month pickers - Internationalization

The month picker supports internationalization through the JavaScript Date object. Specify a BCP 47 language tag using the locale prop, and then set the first day of the week with the first-day-of-week prop.

Month pickers - icons

You can override the default icons used in the picker.

Month pickers - read only

Selecting new date could be disabled by adding readonly prop.

Month pickers - current month indicator

By default the current month is displayed using outline button - show-current prop allows you to remove the border or select different month to be displayed as the current one.

Edit this page | language on Github
Vuetify 3 is now available!The latest version of Vuetify is now available!
Learn about Vuetify 3's new features and functionality for modern Vue applications
Start exploringExplore