Champs date et heure

Sept types de champs stockent des dates, des heures, des durées et des horodatages d'audit gérés par le système. Tous partagent les propriétés de base des champs.

Type	Stocke
date	Une date calendaire, avec composante heure optionnelle.
datetime	Une date et une heure, sensible au fuseau horaire.
time	Une heure de la journée sans date.
duration	Une valeur de temps écoulé / d'heures travaillées (stockée en secondes).
created-at	Horodatage défini par le système, capturé à la création d'un enregistrement.
updated-at	Horodatage mis à jour par le système, rafraîchi à chaque modification.
deleted-at	Horodatage de suppression douce ; NULL signifie que l'enregistrement est actif.

date

Dates calendaires, incluant éventuellement une composante heure.

Propriété	Description
format	Chaîne de format d'affichage libre (par ex. YYYY-MM-DD, MM/DD/YYYY, DD-MM-YYYY).
dateFormat	Préréglage d'affichage : US, European ou ISO.
timeFormat	Affichage de l'heure : 12-hour ou 24-hour.
includeTime	Booléen. Lorsqu'il vaut true, le champ date capture aussi une heure.
timezone	Identifiant de fuseau horaire IANA (par ex. UTC, America/New_York, Europe/London).
timeZone	Réglage de fuseau horaire acceptant une zone spécifique ou local (fuseau du navigateur).
default	Valeur de date par défaut pour les nouveaux enregistrements.

- { id: 1, name: due_date, type: date, dateFormat: ISO, includeTime: false }

datetime

Date et heure. Sensible au fuseau horaire pour une planification inter-régions précise.

Propriété	Description
format	Chaîne de format d'affichage libre (par ex. YYYY-MM-DD HH:mm, MM/DD/YYYY hh:mm A).
dateFormat	Préréglage d'affichage : US, European ou ISO.
timeFormat	Affichage de l'heure : 12-hour ou 24-hour.
timezone	Identifiant de fuseau horaire IANA.
timeZone	Réglage de fuseau horaire acceptant une zone spécifique ou local.
default	Valeur datetime par défaut pour les nouveaux enregistrements.

- { id: 2, name: published_at, type: datetime, timeFormat: 24-hour, timezone: UTC }

time

Valeurs d'heure uniquement, sans date. Utilisé pour les horaires, les heures d'ouverture et les créneaux horaires.

Propriété	Description
timeFormat	Affichage de l'heure : 12-hour ou 24-hour.
default	Heure par défaut au format HH:MM:SS (par ex. 09:00:00).

- { id: 3, name: start_time, type: time, required: true, timeFormat: 24-hour }

duration

Temps écoulé ou heures travaillées, stockés sous forme d'un nombre de secondes.

Propriété	Description
format	Chaîne de format d'affichage libre pour la durée.
displayFormat	Préréglage d'affichage : h:mm, h:mm:ss ou decimal.
default	Valeur de durée par défaut, en secondes, pour les nouveaux enregistrements.

- { id: 4, name: work_hours, type: duration, displayFormat: 'h:mm' }

Horodatages d'audit système

created-at, updated-at et deleted-at sont gérés par le système — leurs valeurs sont définies automatiquement et ne peuvent pas être éditées manuellement. Ils ne prennent aucune propriété spécifique au type au-delà des propriétés de base des champs (souvent indexed: true).

Type	Comportement
created-at	Capturé une fois lors de la création de l'enregistrement. En lecture seule.
updated-at	Rafraîchi automatiquement à chaque modification de l'enregistrement. En lecture seule.
deleted-at	Défini lors de la suppression douce de l'enregistrement. NULL indique un enregistrement actif ; un horodatage = supprimé.

fields:
  - { id: 5, name: created_at, type: created-at, indexed: true }
  - { id: 6, name: updated_at, type: updated-at, indexed: true }
  - { id: 7, name: deleted_at, type: deleted-at, indexed: true }