YearPicker API

API documentation for the React YearPicker component. Learn about the available props and the CSS API.

Import

import { YearPicker } from '@mui/x-date-pickers-pro/YearPicker';
// or
import { YearPicker } from '@mui/x-date-pickers/YearPicker';
// or
import { YearPicker } from '@mui/x-date-pickers-pro';
// or
import { YearPicker } from '@mui/x-date-pickers';

You can learn about the difference by reading this guide on minimizing bundle size.

Component name

The name MuiYearPicker can be used when providing default props or style overrides in the theme.

Props

Name	Type	Default	Description
disableFuture	bool	false	If `true` future days are disabled.
disableHighlightToday	bool	false	If `true`, today's date is rendering without highlighting with circle.
disablePast	bool	false	If `true` past days are disabled.
maxDate	any		Maximal selectable date. @DateIOType
minDate	any		Minimal selectable date. @DateIOType
shouldDisableYear	func		Disable specific years dynamically. Works like `shouldDisableDate` but for year selection view @DateIOType. Signature: `function(year: TDate) => boolean` year: The year to test. returns (boolean): Returns `true` if the year should be disabled.

The ref is forwarded to the root element.

CSS

Rule name	Global class	Description
root	.MuiYearPicker-root	Styles applied to the root element.

You can override the style of the component using one of these customization options:

With a global class name.
With a rule name as part of the component's styleOverrides property in a custom theme.

YearPicker API

Import

Component name

Props

CSS

Demos