Skip to content

PickersDay API

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

Import

import PickersDay from '@mui/lab/PickersDay';
// or
import { PickersDay } from '@mui/lab';
You can learn about the difference by reading this guide on minimizing bundle size.

Component name

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

Props

Props of the native component are also available.

NameTypeDefaultDescription
day*any
The date to show.
outsideCurrentMonth*boolfalse
If true, day is outside of month and will be hidden.
allowSameDateSelectionboolfalse
If true, onChange is fired on click even if the same date is selected.
childrennode
The content of the component.
classesobject
Override or extend the styles applied to the component. See CSS API below for more details.
disabledboolfalse
If true, renders as disabled.
disableHighlightTodayboolfalse
If true, todays date is rendering without highlighting with circle.
disableMarginboolfalse
If true, days are rendering without margin. Useful for displaying linked range of days.
selectedboolfalse
If true, renders as selected.
showDaysOutsideCurrentMonthboolfalse
If true, days that have outsideCurrentMonth={true} are displayed.
sxArray<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.
todayboolfalse
If true, renders as today date.

The ref is forwarded to the root element.

CSS

Rule nameGlobal classDescription
root.MuiPickersDay-rootStyles applied to the root element.
dayWithMargin.MuiPickersDay-dayWithMarginStyles applied to the root element if disableMargin=false.
dayOutsideMonth.MuiPickersDay-dayOutsideMonthStyles applied to the root element if outsideCurrentMonth=true and showDaysOutsideCurrentMonth=true.
hiddenDaySpacingFiller.MuiPickersDay-hiddenDaySpacingFillerStyles applied to the root element if outsideCurrentMonth=true and showDaysOutsideCurrentMonth=false.
today.MuiPickersDay-todayStyles applied to the root element if disableHighlightToday=false and today=true.
selected.Mui-selectedState class applied to the root element if selected=true.
disabled.Mui-disabledState class applied to the root element if disabled=true.

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

Demos