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.

Demos

For examples and details on the usage of this React component, visit the component demo pages:

    Import

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

    Props

    onViewChangeRequired

    Callback called when a toolbar is clicked

    Type:

    func

    Signature:

    function(view: TView) => void
    • view The view to open

    viewRequired

    Currently visible picker view.

    Type:

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

    classes

    Override or extend the styles applied to the component.

    See CSS API below for more details.

    Type:

    object

    className

    className applied to the root component.

    Type:

    string

    hidden

    If true, show the toolbar even in desktop mode.

    Type:

    bool

    Default:

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

    toolbarFormat

    Toolbar date format.

    Type:

    string

    toolbarPlaceholder

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

    Type:

    node

    Default:

    "––"

    The component cannot hold a ref.

    CSS

    The following class names are useful for styling with CSS (the state classes are marked).
    To learn more, visit the component customization page.


    .MuiDateTimePickerToolbar-rootroot

    Styles applied to the root element.


    .MuiDateTimePickerToolbar-dateContainerdateContainer

    Styles applied to the date container element.


    .MuiDateTimePickerToolbar-timeContainertimeContainer

    Styles applied to the time container element.


    .MuiDateTimePickerToolbar-timeDigitsContainertimeDigitsContainer

    Styles applied to the time (except am/pm) container element.


    .MuiDateTimePickerToolbar-timeLabelReversetimeLabelReverse

    Styles applied to the time container if rtl.


    .MuiDateTimePickerToolbar-separatorseparator

    Styles applied to the separator element.


    .MuiDateTimePickerToolbar-ampmSelectionampmSelection

    Styles applied to the am/pm section.


    .MuiDateTimePickerToolbar-ampmLandscapeampmLandscape

    Styles applied to am/pm section in landscape mode.


    .MuiDateTimePickerToolbar-ampmLabelampmLabel

    Styles applied to am/pm labels.


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