DatePicker

Selected date (controlled)

Selection callback

Alias of `date`, matching the value/onValueChange convention of the other inputs; `date` wins when both are set

Alias of `onDateChange`; fired alongside it

Initial value for uncontrolled usage (ignored when `date`/`value` is provided)

Trigger text when no date is selected (default "Pick a date")

Min selectable date

Max selectable date

date-fns format string (default "MMM d, yyyy")

Popover alignment

Footer content rendered under the calendar

The era the field shows by DEFAULT (default "gregory"); "buddhist" renders พ.ศ. years and puts the era chip in the footer. "gregorian" is the deprecated spelling — still accepted and normalised on arrival, so a host passing its own stored Intl calendar value through no longer gets TS2322 and has to translate the word by hand (fb_e8de80fb). The `data-calendar` attribute still writes "gregorian", because consumers already style and test against it

Which era the picker is SHOWING, as a controlled value. Pair with `onCalendarModeChange` to remember the user's choice across opens or sessions. Left alone the picker keeps its own, seeded from `calendar` — and no longer resets it when the popup reopens, which is what stopped the era chip from sticking (fb_20a80f6c). Presentation only: the Date handed back is the same Date in either era. The deprecated "gregorian" spelling is accepted here too and normalised on arrival, so an era a host stored under the old word can be fed straight back in without a type error (fb_e8de80fb); `onCalendarModeChange` always reports the house spelling

Fires with the era the user switched the picker to

Show the era chip even when `calendar` is gregorian, so a ค.ศ. field can be switched to พ.ศ. (default false — a chip appearing in footers that never had one is a change other consumers did not ask for)

Locale for labels and formatting. `locale="th"` now also supplies the Thai BUILT-IN strings (placeholder, era chip พ.ศ./ค.ศ., and for DateRangePicker the whole quick-range rail) — previously the grid localised but the trigger stayed English, which only showed on an EMPTY field. An explicit `labels` (or `placeholder`) still wins, and locale="en" is unchanged. MCP feedback fb_3adc3df4.

Override the built-in UI strings (i18n): placeholder, be, ce, toggleCalendarEra. The three era keys are forwarded to the era chip, so a host that translates nothing else can still rename the พ.ศ./ค.ศ. text and the chip aria-label. Merged over the locale defaults (DEFAULT_DATE_PICKER_LABELS, or TH_DATE_PICKER_LABELS under locale="th"), so a partial object only replaces the keys it names; the explicit `placeholder` prop still wins over labels.placeholder

Disables the trigger

Mark the field invalid (destructive ring); aria-invalid wins when both are set

DOM id set on the trigger button; FormField clones its field id in, and its label then names the control

Accessible name of the trigger when there is no visible label

Id(s) of the element(s) that label the trigger; wins over a FormField label

Id(s) of hint or error text describing the trigger (FormField clones this in)

Mark the trigger invalid; FormField clones this in from its error prop

Accepted (FormField clones it in) but not rendered: ARIA does not allow it on a button. The label text "required" is part of the name instead