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

Date Time Range Field

The Date Time Range Field let the user select a range of dates with an explicit starting and ending time with the keyboard.

Basic usage

You can render your Date Time Range Field with either one input using SingleInputDateTimeRangeField or two inputs using MultiInputDateTimeRangeField as show below.

Check-in

—

Check-out

Check-in - Check-out

<MultiInputDateTimeRangeField
  slotProps={{
    textField: ({ position }) => ({
      label: position === 'start' ? 'Check-in' : 'Check-out',
    }),
  }}
/>
<SingleInputDateTimeRangeField label="Check-in - Check-out" />

<MultiInputDateTimeRangeField
  slotProps={{
    textField: ({ position }) => ({
      label: position === 'start' ? 'Check-in' : 'Check-out',
    }),
  }}
/>
<SingleInputDateTimeRangeField label="Check-in - Check-out" />

Press Enter to start editing

Uncontrolled vs. Controlled

The component can be uncontrolled or controlled.

Uncontrolled field

Controlled field

<SingleInputDateTimeRangeField
  label="Uncontrolled field"
  defaultValue={[dayjs('2022-04-17T15:30'), dayjs('2022-04-21T18:30')]}
/>
<SingleInputDateTimeRangeField
  label="Controlled field"
  value={value}
  onChange={(newValue) => setValue(newValue)}
/>

<SingleInputDateTimeRangeField
  label="Uncontrolled field"
  defaultValue={[dayjs('2022-04-17T15:30'), dayjs('2022-04-21T18:30')]}
/>
<SingleInputDateTimeRangeField
  label="Controlled field"
  value={value}
  onChange={(newValue) => setValue(newValue)}
/>

Press Enter to start editing

API

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