Propriétés

Prop	Type	Défaut	Description
`value`	`Date \| null`	—	Valeur date-heure sélectionnée
`onChange`	`(dateTime: Date \| null) => void`	—	Callback lorsque la valeur change
`time`	`TimeConfig`	—	Configuration du panneau de l’heure
`minDate`	`Date`	—	Date minimale sélectionnable
`maxDate`	`Date`	—	Date maximale sélectionnable
`locale`	`Partial<Locale>`	—	Configuration de la locale personnalisée
`initialMonth`	`Date`	—	Mois initial affiché
`size`	`"small" \| "medium" \| "large" \| "x-large"`	`"medium"`	Taille du composant
`weekStartsOn`	`WeekDay`	`"sunday"`	Premier jour de la semaine
`isDateUnavailable`	`(date: Date) => boolean`	—	Marquer les dates comme désactivées
`displayFormat`	`string`	—	Format d’affichage personnalisé
`open`	`boolean`	—	État d’ouverture contrôlé
`initialOpen`	`boolean`	—	État d’ouverture initial (non contrôlé)
`onOpenChange`	`(open: boolean) => void`	—	Callback lorsque l’état d’ouverture change
`required`	`boolean`	`false`	Désactiver l’effacement de la valeur
`showOutsideDays`	`boolean`	`false`	Afficher les jours des mois adjacents
`highlightDates`	`Date[]`	—	Dates à mettre en surbrillance
`shouldCloseOnSelect`	`boolean`	`false`	Confirmer automatiquement lors du clic sur un préréglage
`numberOfMonths`	`number`	`1`	Nombre de mois à afficher
`captionLayout`	`"buttons" \| "dropdown"`	`"buttons"`	Style de navigation de la légende
`fromYear`	`number`	—	Année de début pour le menu déroulant
`toYear`	`number`	—	Année de fin pour le menu déroulant
`disablePast`	`boolean`	`false`	Désactiver les dates antérieures à aujourd’hui
`disableFuture`	`boolean`	`false`	Désactiver les dates postérieures à aujourd’hui
`inline`	`boolean`	`false`	Afficher le calendrier en ligne (sans popup)
`name`	`string`	—	Nom de l’entrée masquée pour la soumission du formulaire
`placeholder`	`string`	—	Texte du placeholder du déclencheur
`hideHeader`	`boolean`	`false`	Masquer l’en-tête de navigation
`hideFooter`	`boolean`	`false`	Masquer le pied de page des actions

TimeConfig

interface TimeConfig {
  /** Précision d'affichage de l'heure. Par défaut "minute". */
  precision?: "hour" | "minute" | "second";
  /** Format 12 heures ou 24 heures. Par défaut "24". */
  hourFormat?: "12" | "24";
  /** Pas d'incrémentation des minutes. Par défaut 5. */
  minuteStep?: 1 | 2 | 3 | 5 | 10 | 15 | 20 | 30;
  /** Pas d'incrémentation des secondes. Par défaut 1. */
  secondStep?: 1 | 2 | 3 | 5 | 10 | 15 | 20 | 30;
  /** Hauteur (en px) de chaque élément de la molette de défilement. Par défaut 32. */
  itemHeight?: number;
}