Eigenschaften

Prop	Typ	Standard	Beschreibung
`value`	`{ start: Date \| null; end: Date \| null }`	—	Ausgewählter Datums-Zeitbereichswert
`onChange`	`(value: { start: Date \| null; end: Date \| null }) => void`	—	Callback bei Wertänderung
`time`	`TimeConfig`	—	Zeitfenster-Konfiguration (gilt für Start und Ende)
`presets`	`DateRangePreset[]`	—	Vordefinierte Datumsbereich-Presets
`maxDays`	`number`	—	Maximale Anzahl an Tagen im Bereich (inklusiv)
`minDays`	`number`	—	Minimale Anzahl an Tagen im Bereich (inklusiv)
`allowSingleDateInRange`	`boolean`	`true`	Bereich erlauben, bei dem Start- und Enddatum identisch sind
`minDate`	`Date`	—	Minimal auswählbares Datum
`maxDate`	`Date`	—	Maximal auswählbares Datum
`locale`	`Partial<Locale>`	—	Benutzerdefinierte Lokalisierungskonfiguration
`initialMonth`	`Date`	—	Initial angezeigter Monat
`size`	`"small" \| "medium" \| "large" \| "x-large"`	`"medium"`	Komponentengröße
`weekStartsOn`	`WeekDay`	`"sunday"`	Erster Tag der Woche
`isDateUnavailable`	`(date: Date) => boolean`	—	Daten als deaktiviert markieren
`displayFormat`	`string`	—	Benutzerdefiniertes Anzeigeformat
`open`	`boolean`	—	Gesteuerter geöffneter Zustand
`initialOpen`	`boolean`	—	Initialer geöffneter Zustand (ungesteuert)
`onOpenChange`	`(open: boolean) => void`	—	Callback bei Änderung des geöffneten Zustands
`required`	`boolean`	`false`	Löschen des Wertes deaktivieren
`showOutsideDays`	`boolean`	`false`	Tage aus benachbarten Monaten anzeigen
`highlightDates`	`Date[]`	—	Hervorzuhebende Daten
`shouldCloseOnSelect`	`boolean`	`false`	Automatische Bestätigung bei Klick auf ein Preset
`numberOfMonths`	`number`	`2`	Anzahl der anzuzeigenden Monate
`captionLayout`	`"buttons" \| "dropdown"`	`"buttons"`	Navigationsstil der Überschrift
`fromYear`	`number`	—	Startjahr für das Dropdown
`toYear`	`number`	—	Endjahr für das Dropdown
`disablePast`	`boolean`	`false`	Daten vor heute deaktivieren
`disableFuture`	`boolean`	`false`	Daten nach heute deaktivieren
`inline`	`boolean`	`false`	Kalender inline anzeigen (kein Popup)
`name`	`string`	—	Name des versteckten Eingabefelds für die Formularübermittlung (Start-Datum/-Zeit)
`endName`	`string`	—	Name des versteckten Eingabefelds für die End-Datum/-Zeit (standardmäßig `name-end`)
`placeholder`	`string`	—	Platzhaltertext des Auslösers
`hideHeader`	`boolean`	`false`	Navigationskopfzeile ausblenden
`hideFooter`	`boolean`	`false`	Aktionsfußzeile ausblenden

TimeConfig

interface TimeConfig {
  /** Zeit-Anzeigegenauigkeit. Standard ist "minute". */
  precision?: "hour" | "minute" | "second";
  /** 12-Stunden- oder 24-Stunden-Format. Standard ist "24". */
  hourFormat?: "12" | "24";
  /** Schrittweite der Minuten. Standard ist 5. */
  minuteStep?: 1 | 2 | 3 | 5 | 10 | 15 | 20 | 30;
  /** Schrittweite der Sekunden. Standard ist 1. */
  secondStep?: 1 | 2 | 3 | 5 | 10 | 15 | 20 | 30;
  /** Höhe (in px) jedes Scrollrad-Elements. Standard ist 32. */
  itemHeight?: number;
}

DateRangePreset

interface DateRangePreset {
  label: string;
  value: { start: Date; end: Date } | (() => { start: Date; end: Date });
}