Form Inputs

Date Picker

A date picker allows a user to select a date from a popup calendar.

Default value#

Format options#

Dates are formatted with Intl.DateTimeFormat using the locale and formatOptions props.

Disabled#

Controlled#

Component props#

NameTypeDescription
labelstringLabel text displayed above the picker
valueDateControlled date value
defaultValueDateDefault date value
minValueDateMinimum selectable date
maxValueDateMaximum selectable date
placeholderstringText shown when no date is selected (default: "Select date")
localestringLocale used to format the displayed date
formatOptionsIntl.DateTimeFormatOptionsDate format options (default: { dateStyle: "medium" })
isDisabledbooleanDisables the picker
isReadOnlybooleanPrevents changing the value
onChange(date: Date) => voidCalled when a date is selected
buttonPropsButtonPropsProps passed to the trigger button
calendarPropsPartial<CalendarProps>Props passed to the popup calendar