packages/docs/src/pages/en/components/month-pickers.md
The v-month-picker component is a standalone picker that allows users to select a month and year combination.
::: warning
This feature requires v4.1.0
:::
Labs components require manual import and registration with the Vuetify instance.
import { VMonthPicker } from 'vuetify/labs/VMonthPicker'
At its core, the month picker allows selecting a specific month and year. The model value is a string in YYYY-MM format.
| Component | Description |
|---|---|
| v-month-picker | Primary Component |
| v-date-picker-years | Sub-component used to display years |
The v-month-picker component is built on top of v-picker and reuses internal date picker sub-components for rendering month and year views.
The allowed-months prop restricts which months can be selected. It accepts an array of month numbers (0-11) or a function that returns a boolean.
The multiple prop enables selecting more than one month. Set it to true for arbitrary multi-select or 'range' for range selection where the first and last clicks define the range boundaries. In range mode, the months between the endpoints receive a tinted background.
The min and max props restrict the selectable range. Both accept strings in YYYY-MM format.
The month picker can be integrated into a v-menu or v-dialog, allowing users to pick a month from a text field activator.