React Date Range Input Component

Date Range Input

CoreUI PRO
This component is part of CoreUI PRO – a powerful UI library with over 250 components and 25+ templates, designed to help you build modern, responsive apps faster. Fully compatible with Angular, Bootstrap, React.js, and Vue.js.

Create a React start and end date field in one frame. Both ends use the section-based mask of the date input, and the range is validated as a whole.

Available in Other JavaScript Frameworks

CoreUI React Date Range Input Component is also available for Bootstrap and Vue. Explore framework-specific implementations below:

Example

Added in v6.0.0

The React Date Range Input component is two date input fields and a separator in one frame, held together by the range it owns: both ends share the mask and the limits, and an end before the start marks the whole field invalid.

Each end follows the standard React controlled/uncontrolled pattern of its own: use defaultStartDate / defaultEndDate for an uncontrolled field, or pair startDate / endDate with onStartDateChange / onEndDateChange for a controlled one. A native reset of the form puts back the date each end started with, and a controlled end only asks for it through its callback.

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput label="Stay" locale="en-US" />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          defaultEndDate="2026-07-20"
          defaultStartDate="2026-07-14"
          label="Stay"
          locale="en-US"
        />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput label="Stay" locale="en-US" />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          defaultEndDate="2026-07-20"
          defaultStartDate="2026-07-14"
          label="Stay"
          locale="en-US"
        />
      </CCol>
    </CRow>
  )
}

Date and time

Set type="datetime" and both ends carry the time. The hour cycle follows the locale, and seconds adds a seconds section to each field. The range compares its two ends by instant, so an end earlier in the day than the start on the same date marks the field invalid.

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputDateTimeExample = () => {
  return (
    <CRow>
      <CCol lg={7}>
        <CDateRangeInput
          endName="shift-end"
          label="Shift"
          locale="en-US"
          startName="shift-start"
          type="datetime"
        />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputDateTimeExample = () => {
  return (
    <CRow>
      <CCol lg={7}>
        <CDateRangeInput
          endName="shift-end"
          label="Shift"
          locale="en-US"
          startName="shift-start"
          type="datetime"
        />
      </CCol>
    </CRow>
  )
}

With form field

Wrap the control in <CFormField> to lay it out with its label and description, and to get validation feedback in the right place.

import React from 'react'
import { CCol, CFormField, CFormLabel, CFormText, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputFormFieldExample = () => {
  return (
    <CRow>
      <CCol lg={6}>
        <CFormField>
          <CFormLabel id="dateRangeInputStayLabel">Stay</CFormLabel>
          <CDateRangeInput
            aria-labelledby="dateRangeInputStayLabel"
            endName="stayEnd"
            locale="en-US"
            startName="stayStart"
          />
          <CFormText>Check-out has to be on or after check-in.</CFormText>
        </CFormField>
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CFormField, CFormLabel, CFormText, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputFormFieldExample = () => {
  return (
    <CRow>
      <CCol lg={6}>
        <CFormField>
          <CFormLabel id="dateRangeInputStayLabel">Stay</CFormLabel>
          <CDateRangeInput
            aria-labelledby="dateRangeInputStayLabel"
            endName="stayEnd"
            locale="en-US"
            startName="stayStart"
          />
          <CFormText>Check-out has to be on or after check-in.</CFormText>
        </CFormField>
      </CCol>
    </CRow>
  )
}

Formats

Set an explicit mask for both ends with the format property. The parser is the date input’s, so dayjs/moment tokens (DD, MM, YYYY) and date-fns/Unicode tokens (dd, MM, yyyy) both work, and any other character becomes a literal separator.

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputFormatsExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput format="dd.MM.yyyy" label="dd.MM.yyyy" locale="en-US" />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput format="YYYY-MM-DD" label="YYYY-MM-DD" locale="en-US" />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputFormatsExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput format="dd.MM.yyyy" label="dd.MM.yyyy" locale="en-US" />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput format="YYYY-MM-DD" label="YYYY-MM-DD" locale="en-US" />
      </CCol>
    </CRow>
  )
}

A mask that leaves out sections works here too — a month-and-year range reports the first day of each month:

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputPartialMasksExample = () => {
  return (
    <CRow>
      <CCol lg={5}>
        <CDateRangeInput format="MM.yyyy" label="Reporting period" locale="en-US" />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputPartialMasksExample = () => {
  return (
    <CRow>
      <CCol lg={5}>
        <CDateRangeInput format="MM.yyyy" label="Reporting period" locale="en-US" />
      </CCol>
    </CRow>
  )
}

For picking a whole range on a calendar, use the date range picker.

Month names

Use the MMM or MMMM tokens for text month sections in both ends; typing letters matches a month by prefix. Pass all twelve names through the monthNames property to override the locale-derived, date-context grammatical form.

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

const POLISH_MONTHS = [
  'styczeń',
  'luty',
  'marzec',
  'kwiecień',
  'maj',
  'czerwiec',
  'lipiec',
  'sierpień',
  'wrzesień',
  'październik',
  'listopad',
  'grudzień',
]

export const DateRangeInputMonthNamesExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput format="DD MMMM YYYY" label="DD MMMM YYYY" locale="en-US" />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          format="DD MMMM YYYY"
          label="Standalone Polish month names"
          locale="pl-PL"
          monthNames={POLISH_MONTHS}
        />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

const POLISH_MONTHS = [
  'styczeń',
  'luty',
  'marzec',
  'kwiecień',
  'maj',
  'czerwiec',
  'lipiec',
  'sierpień',
  'wrzesień',
  'październik',
  'listopad',
  'grudzień',
]

export const DateRangeInputMonthNamesExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput format="DD MMMM YYYY" label="DD MMMM YYYY" locale="en-US" />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          format="DD MMMM YYYY"
          label="Standalone Polish month names"
          locale="pl-PL"
          monthNames={POLISH_MONTHS}
        />
      </CCol>
    </CRow>
  )
}

Locale

Without an explicit format, both masks follow the locale set via the locale property.

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputLocalesExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput label="en-US" locale="en-US" />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput label="ja-JP" locale="ja-JP" />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputLocalesExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput label="en-US" locale="en-US" />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput label="ja-JP" locale="ja-JP" />
      </CCol>
    </CRow>
  )
}

Min and max dates

minDate and maxDate constrain both ends. A completed date outside the range gets the .is-invalid class on its own field and that end reports null until the value is corrected.

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputMinMaxExample = () => {
  return (
    <CRow>
      <CCol lg={5}>
        <CDateRangeInput
          format="dd.MM.yyyy"
          label="Dates in July 2026"
          locale="en-US"
          maxDate={new Date(2026, 6, 31)}
          minDate={new Date(2026, 6, 1)}
        />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputMinMaxExample = () => {
  return (
    <CRow>
      <CCol lg={5}>
        <CDateRangeInput
          format="dd.MM.yyyy"
          label="Dates in July 2026"
          locale="en-US"
          maxDate={new Date(2026, 6, 31)}
          minDate={new Date(2026, 6, 1)}
        />
      </CCol>
    </CRow>
  )
}

Disabled dates

Beyond a simple range, the disabledDates property excludes specific dates from both ends — single Dates, [start, end] ranges, or a matcher function.

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputDisabledDatesExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput
          defaultStartDate={new Date(2026, 6, 10)}
          disabledDates={[[new Date(2026, 6, 4), new Date(2026, 6, 7)], new Date(2026, 6, 16)]}
          format="dd.MM.yyyy"
          label="Stay"
          maxDate={new Date(2026, 6, 31)}
          minDate={new Date(2026, 6, 1)}
        />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          disabledDates={(date: Date) => date.getDay() === 0 || date.getDay() === 6}
          format="dd.MM.yyyy"
          label="Business days"
        />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputDisabledDatesExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput
          defaultStartDate={new Date(2026, 6, 10)}
          disabledDates={[[new Date(2026, 6, 4), new Date(2026, 6, 7)], new Date(2026, 6, 16)]}
          format="dd.MM.yyyy"
          label="Stay"
          maxDate={new Date(2026, 6, 31)}
          minDate={new Date(2026, 6, 1)}
        />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          disabledDates={(date: Date) => date.getDay() === 0 || date.getDay() === 6}
          format="dd.MM.yyyy"
          label="Business days"
        />
      </CCol>
    </CRow>
  )
}

Custom formats

The built-in token parser covers dayjs, moment, date-fns, and luxon format strings, so you can reuse the format string from the date library you already work with — the library itself isn’t required to render or edit the masks. Pair it with inputDateParse when you want that library to also parse text pasted into either end, here with date-fns:

import React from 'react'
import { parse } from 'date-fns'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputCustomFormatsExample = () => {
  return (
    <CRow>
      <CCol lg={6}>
        <CDateRangeInput
          defaultEndDate={new Date(2026, 6, 20)}
          defaultStartDate={new Date(2026, 6, 14)}
          format="MMMM DD, YYYY"
          inputDateParse={(value) => parse(value, 'MMMM dd, yyyy', new Date())}
          label="date-fns format"
          locale="en-US"
        />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { parse } from 'date-fns'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputCustomFormatsExample = () => {
  return (
    <CRow>
      <CCol lg={6}>
        <CDateRangeInput
          defaultEndDate={new Date(2026, 6, 20)}
          defaultStartDate={new Date(2026, 6, 14)}
          format="MMMM DD, YYYY"
          inputDateParse={(value) => parse(value, 'MMMM dd, yyyy', new Date())}
          label="date-fns format"
          locale="en-US"
        />
      </CCol>
    </CRow>
  )
}

Validation

The frame shows the state of the range and each field shows its own, the way <CForm> does for a native field. Each end keeps its value in a <textarea> laid invisibly over its field, which takes part in native constraint validation: a required end that is empty, incomplete or holds a rejected date blocks the submit, and the browser, or <CForm>, puts focus on its first empty section.

import React, { useState } from 'react'
import { CButton, CCol, CDateRangeInput, CForm } from '@coreui/react-pro'

export const DateRangeInputValidationExample = () => {
  const [stayState, setStayState] = useState<string | undefined>('invalid')

  return (
    <CForm className="row g-4" noValidate validate>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          defaultEndDate={new Date(2026, 6, 14)}
          defaultStartDate={new Date(2026, 6, 20)}
          endName="check-out"
          feedbackInvalid="Check-out has to be on or after check-in."
          format="dd.MM.yyyy"
          label="Out of order"
          locale="en-US"
          startName="check-in"
        />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          defaultEndDate={new Date(2026, 6, 20)}
          defaultStartDate={new Date(2026, 6, 14)}
          endName="to"
          feedback="Those dates are already booked."
          format="dd.MM.yyyy"
          label="Stay"
          locale="en-US"
          onValidationStateChange={setStayState}
          startName="from"
          validationState={stayState}
        />
      </CCol>
      <CCol xs={12}>
        <CButton color="primary" type="submit">
          Submit
        </CButton>
      </CCol>
    </CForm>
  )
}
import React, { useState } from 'react'
import { CButton, CCol, CDateRangeInput, CForm } from '@coreui/react-pro'

export const DateRangeInputValidationExample = () => {
  const [stayState, setStayState] = useState<string | undefined>('invalid')

  return (
    <CForm className="row g-4" noValidate validate>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          defaultEndDate={new Date(2026, 6, 14)}
          defaultStartDate={new Date(2026, 6, 20)}
          endName="check-out"
          feedbackInvalid="Check-out has to be on or after check-in."
          format="dd.MM.yyyy"
          label="Out of order"
          locale="en-US"
          startName="check-in"
        />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          defaultEndDate={new Date(2026, 6, 20)}
          defaultStartDate={new Date(2026, 6, 14)}
          endName="to"
          feedback="Those dates are already booked."
          format="dd.MM.yyyy"
          label="Stay"
          locale="en-US"
          onValidationStateChange={setStayState}
          startName="from"
          validationState={stayState}
        />
      </CCol>
      <CCol xs={12}>
        <CButton color="primary" type="submit">
          Submit
        </CButton>
      </CCol>
    </CForm>
  )
}

The state comes from these places, in this order:

  • The order: an end before the start is a state of the range, not of either date, and only dates the limits accept take part in it, so .is-invalid lands on the frame and both fields stay editable. Every section of both fields carries aria-invalid="true" until the order is fixed, and neither field is drawn valid meanwhile, whatever else is set.
  • The limits: a completed date outside minDate/maxDate/disabledDates makes its own field invalid, which the frame picks up, and that field’s value field submits no date until it is corrected. A date before year 1 counts as before minDate even without that prop; when the field loses the focus, its year becomes 1.
  • validationState: 'valid', 'invalid' or a state you added to $form-validation-states, a verdict on the whole range that lands on the frame and on both ends.
  • A validation that reports a field (a submit, checkValidity() or reportValidity(), which <CForm> and the stepper call as well), and in a form with the validate property of <CForm> the :user-invalid state of each value field, with validate="valid" also its :user-valid state, as for the date input.

A state you give is a verdict on the range it was given for. When the user changes either end, or the form is reset, the component calls onValidationStateChange(undefined) before it reports the change; pass your state setter there to drop the state from both ends and the frame, as the second range above does. A change your code makes through startDate or endDate asks nothing. While the given state is 'invalid', both ends block the submit with the text of the message after the frame, or Invalid value. when there is none, unless the range is disabled or read-only. A native form reset returns both ends to the dates they started with; a reset listener that calls preventDefault() cancels the whole reset. An end your page controls keeps the value it gives it.

While an end is invalid, an .invalid-feedback or .invalid-tooltip you render after the range describes each of its sections.

Blocking the submit

A required end that is empty, incomplete or rejected by the limits blocks the submit by itself. An end before the start does not, since both ends hold dates the browser accepts, and neither does an optional end that is empty, incomplete or rejected, which submits no date. Check the dates before you send them; onStartDateChange and onEndDateChange report null for an end that is empty, incomplete or rejected, so one condition covers both:

const [start, setStart] = useState<Date | null>(null)
const [end, setEnd] = useState<Date | null>(null)

return (
  <CForm
    onSubmit={(event) => {
      if (!start || !end || end < start) {
        event.preventDefault()
      }
    }}
  >
    <CDateRangeInput onEndDateChange={setEnd} onStartDateChange={setStart} />
    <CButton type="submit">Book</CButton>
  </CForm>
)

Floating labels

Each end can carry its own floating label through startFloatingLabel and endFloatingLabel; the text is also that end’s accessible name.

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputFloatingLabelsExample = () => {
  return (
    <CRow>
      <CCol lg={6}>
        <CDateRangeInput
          endFloatingLabel="Check-out"
          locale="en-US"
          startFloatingLabel="Check-in"
        />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputFloatingLabelsExample = () => {
  return (
    <CRow>
      <CCol lg={6}>
        <CDateRangeInput
          endFloatingLabel="Check-out"
          locale="en-US"
          startFloatingLabel="Check-in"
        />
      </CCol>
    </CRow>
  )
}

Set floatingLabelAlways to keep both labels always floating with the masks showing.

Separator

The separator property takes a node, so the arrow between the two ends can be a word, an icon of your own, or anything else you render. It is hidden from assistive technology either way. Left out, the default arrow renders and flips for right-to-left.

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputSeparatorExample = () => {
  return (
    <CRow>
      <CCol lg={6}>
        <CDateRangeInput label="Stay" locale="en-US" separator={<span className="fg-2">to</span>} />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputSeparatorExample = () => {
  return (
    <CRow>
      <CCol lg={6}>
        <CDateRangeInput label="Stay" locale="en-US" separator={<span className="fg-2">to</span>} />
      </CCol>
    </CRow>
  )
}

Sizing

The frame is a .form-control-group, so the standard sizing works — set the size property to lg or sm and both ends follow.

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputSizingExample = () => {
  return (
    <CRow>
      <CCol className="mb-4" lg={6}>
        <CDateRangeInput label="Large" locale="en-US" size="lg" />
      </CCol>
      <CCol lg={6}>
        <CDateRangeInput label="Small" locale="en-US" size="sm" />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputSizingExample = () => {
  return (
    <CRow>
      <CCol className="mb-4" lg={6}>
        <CDateRangeInput label="Large" locale="en-US" size="lg" />
      </CCol>
      <CCol lg={6}>
        <CDateRangeInput label="Small" locale="en-US" size="sm" />
      </CCol>
    </CRow>
  )
}

Disabled and readonly

Set the disabled property to disable both ends, or readOnly to make them focusable but non-editable.

import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputDisabledReadonlyExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput
          defaultEndDate={new Date(2026, 6, 20)}
          defaultStartDate={new Date(2026, 6, 14)}
          disabled
          format="dd.MM.yyyy"
          label="Disabled"
          locale="en-US"
        />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          defaultEndDate={new Date(2026, 6, 20)}
          defaultStartDate={new Date(2026, 6, 14)}
          format="dd.MM.yyyy"
          label="Readonly"
          locale="en-US"
          readOnly
        />
      </CCol>
    </CRow>
  )
}
import React from 'react'
import { CCol, CRow } from '@coreui/react'
import { CDateRangeInput } from '@coreui/react-pro'

export const DateRangeInputDisabledReadonlyExample = () => {
  return (
    <CRow>
      <CCol className="mb-4 mb-sm-0" sm={6} lg={5}>
        <CDateRangeInput
          defaultEndDate={new Date(2026, 6, 20)}
          defaultStartDate={new Date(2026, 6, 14)}
          disabled
          format="dd.MM.yyyy"
          label="Disabled"
          locale="en-US"
        />
      </CCol>
      <CCol sm={6} lg={5}>
        <CDateRangeInput
          defaultEndDate={new Date(2026, 6, 20)}
          defaultStartDate={new Date(2026, 6, 14)}
          format="dd.MM.yyyy"
          label="Readonly"
          locale="en-US"
          readOnly
        />
      </CCol>
    </CRow>
  )
}

Accessibility

Each end is a date input with the spinbutton pattern per section, so the range is two labelled groups rather than one opaque control:

  • Role attributes: each end has role="group", every section is a role="spinbutton" with its value attributes.
  • Names: label names the pair, because the frame around both ends is a role="group" pointing at it; the start and end are named separately — ariaStartLabel and ariaEndLabel by default, or the floating label text when one is set. Each end is described by an aria-describedby you pass, then by text and the feedback that matches the state of the range.
  • Label click: clicking the label that names the pair moves focus to the first empty section of the start date, as clicking the label of an input focuses it.
  • Separator: hidden from assistive technology, whatever you render into it.
  • Roving tabindex: each end is a single tab stop; Tab moves from the start to the end.

Keyboard support

KeyAction
0–9Type into the focused section; the caret advances when the section is complete
A–ZIn text month sections, match a month name by prefix
Arrow Up / Arrow DownIncrement / decrement the focused section
Arrow Right / Arrow LeftMove focus to the next / previous section, crossing the separator from the last section of the start date into the end date and back; in a right-to-left layout the two keys swap
Home / EndMove focus to the first / last section of the focused end
BackspaceClear the focused section; move to the previous section when already empty
DeleteClear the focused section
TabMove from the start date to the end date
Ctrl + A / Cmd + ASelect the whole value of the focused end
Ctrl + V / Cmd + VPaste a date into the focused end

Apart from the shortcuts in the table, a key pressed with Alt, Ctrl or Cmd changes nothing in the field and is not cancelled: arrows, Home and End move no focus and change no section, and a digit or letter is not entered. The key stays free for the browser, assistive technology and the picker around the field, where Alt + Arrow Down opens the calendar. A character that AltGr or Option composes is still entered.