Date Picker

A date picker is a calendar rendered as an input: a grid of days a reader clicks instead of typing, with today, the picked day and the unavailable days each drawn differently. Orvain's Date Picker family covers five of them, the picker on its own, a range picker with a preset rail and two months side by side, a form field that also shows what the chosen day already holds, a booking card pairing a month of availability with that day's slots, and a week strip over the day's schedule.

The grid is the easy half. What breaks a date field is everything around it: people paste dates in formats the parser was never shown, a range whose end falls before its start has to be caught without discarding the pick, and a calendar date is not an instant, store one as a timestamp and a colleague five timezones away reads the day before. Decide early whether the value is a day on a wall calendar or a moment in time, because the two need different storage.

6 blocks

Week schedule

A day's plan under a week strip: dashboards, team pages, anything that opens on today

Day planner

A to-do list for the day under a week strip: habit trackers, personal dashboards, daily plans

Booking

Scheduling pages: a host, a month of availability and the day's times, one step at a time

Event date

Picking a date in a form while seeing what that day already holds, drawn to scale

Date picker

The picker on its own, with quick picks for the usual days: a popover for a field, a filter, a form step

Range picker

Reports and filters: presets for the common spans, two months for everything else

01

Using Date Picker

Reach for it when

  • A form field whose value is a calendar day and the reader knows roughly which one.
  • A report filter where the common answers are spans: last week, this month, last quarter.
  • Booking, where availability differs day by day and the grid has to show which days still have room.
  • A field where the neighbouring days carry information: days already committed, days blacked out.

Reach for something else when

  • A date of birth or anything decades away. Paging back hundreds of months is punishment; use a typed field with a forgiving parser, or year and month selects.
  • An operator entering dates all day, faster than they can click. Keep the typed input primary and hang the calendar off it as an optional popover.
  • A time of day or a duration. A day grid has nowhere to put 09:30. That is a time picker's job.
02

Where it shows up

01

Booking a call

A scheduling page shows the host, the month with unavailable days dimmed, and the slots for whichever day is picked. The footer reads back the date, time and timezone before anything is confirmed.

02

Report date range

Analytics filters where most readers want a named span and a few want an exact one. Presets answer the common case in a click; the two-month grid is there for the quarter that ended on a Tuesday.

03

Task due date

A due-date field in an issue form, with dots on the days that already carry work. The picker doubles as a load check, so a deadline lands on a quiet day rather than the busiest one.

04

Week planner header

A dashboard that opens on today: a strip of seven day cards with dots for what each holds, and the picked day's agenda underneath. Stepping a week is one button, not a month grid.

03

Questions

Which month should a date picker open on?

The month holding the current value, so the reader sees their own choice in context rather than having to find it again. With an empty field, open on the current month and put the focus ring on today. When a minimum date rules out today, such as a booking that needs two days' notice, open on the first month that contains a selectable day.

How do you make a date picker usable from the keyboard?

All blocks
The Orvain Dispatch

Premium components, free in your inbox.

Join the Orvain Dispatch and get production-ready components, free to keep: React and Vue code plus the Figma frame, yours to ship.

Just components, never spam. You can unsubscribe anytime.