Dates et fuseaux

Toute date échangée est en UTC ; ce qui entre déclare son fuseau, ce qui s'affiche se convertit chez vous.

2 min de lecture Mise à jour le 11 novembre 2026

Ce que l'API rend

Toute date rendue est en UTC, au format ISO 8601, suffixée d'un Z :

JSON

{ "CreationDate": "2026-11-03T09:15:00.000Z" }

Convertissez-la dans le fuseau de votre utilisateur au moment de l'afficher : l'API ne le connaît pas et ne le devine pas.

Ce que vous envoyez

Envoyez chaque date avec son fuseau : un Z (UTC), ou un décalage.

JSON

{ "DueDate": "2026-12-15T17:00:00+01:00" }

L'API la ramène en UTC (2026-12-15T16:00:00Z) avant de l'enregistrer ou de la comparer. Une date sans fuseau est lue en UTC : 2026-12-15T17:00:00 vaut 17:00 UTC, soit 18:00 à Paris en hiver.

La valeur d'un filtre de liste suit la même règle : CreationDate comparée par >= à "2026-11-10T10:00:00+02:00" retient ce qui a été créé à partir de 08:00 UTC — voir Lire des listes.

Les cas particuliers

Un événement d'une journée entière (calendrier) commence à minuit UTC du jour ; sa fin, exclue, est minuit UTC du jour suivant.
Les emails et les documents que Docage écrit (un champ de date fusionné dans un contrat, une date dans un email) portent l'heure du fuseau de leur expéditeur : c'est l'heure qu'un lecteur attend sur un document qu'on lui envoie.
Une période (début et fin d'un filtre de dates) s'entend début inclus, fin exclue. Seul l'opérateur between d'un filtre de liste garde ses deux bornes.