🚀 MUI X v6 is out! Discover what's new and get started now!

Date Time Field

The Date Time Field component lets the user select a date and a time with the keyboard.

Basic usage

Basic date time field

<DateTimeField label="Basic date time field" />

<DateTimeField label="Basic date time field" />

Press Enter to start editing

Uncontrolled vs. Controlled

The component can be uncontrolled or controlled.

Uncontrolled field

Controlled field

<DateTimeField
  label="Uncontrolled field"
  defaultValue={dayjs('2022-04-17T15:30')}
/>
<DateTimeField
  label="Controlled field"
  value={value}
  onChange={(newValue) => setValue(newValue)}
/>

<DateTimeField
  label="Uncontrolled field"
  defaultValue={dayjs('2022-04-17T15:30')}
/>
<DateTimeField
  label="Controlled field"
  value={value}
  onChange={(newValue) => setValue(newValue)}
/>

Press Enter to start editing

Customize the date time format

Format with meridiem

Format without meridiem

Localized format with full letter month

Localization

Use the LocalizationProvider to change the date-library locale used in the date time field. See the localization documentation page for more details.

Validation

See the documentation page validation documentation page for more details.

API

See the documentation below for a complete reference to all of the props and classes available to the components mentioned here.

<DateTimeField />