Whether the calendar starts open, when open isn't controlled.

The date, or { from, to } range, selected at first, when it isn't controlled.

true disables the whole picker. Anything else names days that can't be selected, the ways Calendar's disabled does: a date, a list of dates, a function that returns true for a date, { before }, { after } or { dayOfWeek }.

Whether days from the previous and next months can't be selected.

The form field name of the end date, in range mode.

Whether every month shows six weeks, so the calendar's height doesn't change between months.

How the button shows a date: "PPP" for September 26, 2026, "LLL dd, y" for Sep 26, 2026, or "yyyy-MM-dd" for 2026-09-26. With locale, the first two follow that locale's long and medium date styles.

Replaces this icon. Accepts any node; null renders no icon. Takes precedence over IconProvider.

Replaces the built-in text for this instance. See LabelsProvider to change it everywhere.

A BCP 47 locale, such as "de-DE", for the button's date and the calendar's month and weekday names. Defaults to English.

The latest date that can be selected, by clicking or typing.

The earliest date that can be selected, by clicking or typing.

Whether the user picks one date (single) or a start and end date (range).

The form field name. The date is submitted as YYYY-MM-DD; in range mode this is the start date's name.

How many months the calendar shows side by side.

Called when the calendar opens or closes.

Called with the new date, or the new { from, to } range, when the user picks or types one.

Whether the calendar is open. Use with onOpenChange to control it.

The text shown when no date is selected.

Whether a date is required.

Whether the calendar shows the days of the previous and next months that fill the first and last weeks.

The side of the trigger the calendar opens on.

The gap between the trigger and the calendar, in pixels.

Classes for the button or input that opens the calendar.

The Button size of the trigger, when triggerType is button.

What opens the calendar: a button showing the formatted date, or an input the user can also type a date into.

The Button variant of the trigger, when triggerType is button.

The selected date, or { from, to } in range mode. Use null for no date while controlled, and update it from onSelect.

The first day of the week, from 0 for Sunday to 6 for Saturday.