Components
← All components

Date Range Picker

stimeo--date-range-picker

A calendar where two clicks pick a range, showing the range as you choose it.

  • Core
  • Date Picker Dialog

Picks a period on a calendar with two clicks. The first sets the start, and the range to the day you are pointing at is shaded as a preview. The second sets the end, and choosing a day before the start simply swaps them. Both ends of the range are announced, while the days in between are marked for painting only. Shortcuts such as today, the last seven days or this month can sit alongside it. Pressing Esc part-way through drops the preview and starts over. The finished range is announced and handed to the form. Keyboard movement works as it does in the calendar.

running

This demo marks three and four days from today as unavailable, as an example of closed days. A range may span them, but neither can be the start or the end.

Keyboard

KeyAction
Moves focus to the previous day, transitioning to the previous month automatically if crossing boundaries. Under RTL this is ArrowRight.
Moves focus to the next day, transitioning to the next month automatically if crossing boundaries. Under RTL this is ArrowLeft.
Moves focus to the same day of the previous week, transitioning to the previous month if necessary.
Moves focus to the same day of the next week, transitioning to the next month if necessary.
PageUp Moves focus to the same day of the previous month.
PageDown Moves focus to the same day of the next month.
Shift+PageUp / Shift+PageDown Moves focus to the same day of the previous / next year, clamping missing dates to the end of the month.
Home Moves focus to the first day of the current week.
End Moves focus to the last day of the current week.
Enter / Space Confirms the focused day as the start, then the end of the range.
Escape Discards an in-progress selection (the confirmed range is kept).