Design System
Forms

Date picker

Select a single date from a calendar with month and year dropdowns. For a start and end together use Date range picker.

Purpose

A field that opens a calendar. Month and year dropdowns matter more than they look: without them, picking a date of birth means dozens of clicks.

Example

Props

PropTypeDefaultDescription
valueDate | undefinedThe currently selected date (controlled).
onChange((date: Date | undefined) => void) | undefinedCalled with the new date, or `undefined` when the selection is cleared.
placeholderstring | undefined"Pick a date"Trigger text shown when no date is selected.
idstring | undefined`id` forwarded to the trigger button, for pairing with a `<Label htmlFor>`.
classNamestring | undefined

On this page