Skip to content

Date pickers - month ​

v-date-picker can be used as a standalone month picker component.

Usage ​

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

API ​

Caveats ​

WARNING

v-date-picker accepts ISO 8601 date strings (YYYY-MM-DD). For more information regarding ISO 8601 and other standards, visit the official ISO (International Organization for Standardization) International Standards page.

Examples ​

Props ​

Allowed months ​

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

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.

Icons ​

You can override the default icons used in the picker.

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.

Readonly ​

Selecting new date could be disabled by adding readonly prop.

Show current ​

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

Width ​

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

Misc ​

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 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.

Internationalization ​

The month picker supports internationalization through the JavaScript Date object. Specify a BCP 47 language tag using the locale prop.

Orientation ​

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