MonthPicker API

API reference docs for the React MonthPicker component. Learn about the props, CSS, and other APIs of this exported module.

Import

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

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

Component name

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

Props

Name	Type	Default	Description
date^*	any		Date value for the MonthPicker
onChange^*	func		Callback fired on date change.
classes	object		Override or extend the styles applied to the component. See CSS API below for more details.
className	string		className applied to the root element.
disabled	bool	false	If `true` picker is disabled
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
readOnly	bool	false	If `true` picker is readonly
shouldDisableMonth	func		Disable specific months dynamically. Works like `shouldDisableDate` but for month selection view @DateIOType. Signature: `function(month: TDate) => boolean` month: The month to check. returns (boolean): If `true` the month will be disabled.
sx	Array<func \| object \| bool> \| func \| object		The system prop that allows defining system overrides as well as additional CSS styles. See the `sx` page for more details.

The ref is forwarded to the root element.

CSS

Rule name	Global class	Description
root	.MuiMonthPicker-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.

MonthPicker API

Import

Component name

Props

CSS

Demos