Skip to content

DateTimePickerToolbar API

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

Component demos

Import

import { DateTimePickerToolbar } from '@mui/x-date-pickers/DateTimePicker';
// or
import { DateTimePickerToolbar } from '@mui/x-date-pickers';
// or
import { DateTimePickerToolbar } from '@mui/x-date-pickers-pro';
Learn about the difference by reading this guide on minimizing bundle size.

Props

NameTypeDefaultDescription
onViewChange*func-

Callback called when a toolbar is clicked

Signature:function(view: TView) => void
  • view The view to open
views*Array<'day'
| 'hours'
| 'meridiem'
| 'minutes'
| 'month'
| 'seconds'
| 'year'>
-

Available views.

classesobject-

Override or extend the styles applied to the component.

See CSS API below for more details.

hiddenbool`true` for Desktop, `false` for Mobile.

If true, show the toolbar even in desktop mode.

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.

toolbarFormatstring-

Toolbar date format.

toolbarPlaceholdernode"––"

Toolbar value placeholder—it is displayed when the value is empty.

toolbarTitlenode-

If provided, it will be used instead of dateTimePickerToolbarTitle from localization.

view'day'
| 'hours'
| 'meridiem'
| 'minutes'
| 'month'
| 'seconds'
| 'year'
-

Currently visible picker view.

The component cannot hold a ref.

CSS classes

These class names are useful for styling with CSS. They are applied to the component's slots when specific states are triggered.

Class nameRule nameDescription
.MuiDateTimePickerToolbar-ampmLabelampmLabelStyles applied to am/pm labels.
.MuiDateTimePickerToolbar-ampmLandscapeampmLandscapeStyles applied to am/pm section in landscape mode.
.MuiDateTimePickerToolbar-ampmSelectionampmSelectionStyles applied to the am/pm section.
.MuiDateTimePickerToolbar-dateContainerdateContainerStyles applied to the date container element.
.MuiDateTimePickerToolbar-rootrootStyles applied to the root element.
.MuiDateTimePickerToolbar-separatorseparatorStyles applied to the separator element.
.MuiDateTimePickerToolbar-timeContainertimeContainerStyles applied to the time container element.
.MuiDateTimePickerToolbar-timeDigitsContainertimeDigitsContainerStyles applied to the time (except am/pm) container element.
.MuiDateTimePickerToolbar-timeLabelReversetimeLabelReverseStyles applied to the time container if rtl.

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