DateTime

Représentation JSON
{
  "date": string
}
Champs
date

string

Date/heure exprimée dans le format étendu de la norme ISO 8601. Un décalage peut être requis ou non (consultez la documentation du champ parent). L'heure peut être indiquée à la nanoseconde près. Les décalages peuvent être indiqués à la seconde près (même si le décalage des secondes n'est pas prévu par la norme ISO 8601).

Exemple :

1985-04-12T23:20:50.52Z correspond à 20 minutes et 50,52 secondes après la 23e heure, le 12 avril 1985, selon le fuseau UTC.

1985-04-12T19:20:50.52-04:00 correspond à 20 minutes et 50,52 secondes après la 19e heure, le 12 avril 1985, 4 heures avant l'UTC (le même instant dans le temps que l'exemple ci-dessus). Si la date et l'heure sont destinées à un emplacement physique situé à New York, il s'agit de l'équivalent de l'heure avancée de l'Est (EDT). N'oubliez pas que le décalage varie en fonction de la période de l'année dans les régions qui appliquent le passage à l'heure d'été.

1985-04-12T19:20:50.52 correspond à 20 minutes et 50,52 secondes après la 19e heure, le 12 avril 1985, sans information de décalage.

Le fait d'indiquer un décalage fait de cette date un instant absolu dans le temps, dans le monde entier. La date et l'heure seront ajustées en fonction du fuseau horaire de l'utilisateur. Par exemple, l'heure 2018-06-19T18:30:00-04:00 correspondra à 18:30:00 pour un utilisateur situé à New York et à 15:30:00 pour un utilisateur situé à Los Angeles.

Si vous omettez le décalage, la date et l'heure sont locales et représentent plusieurs instants dans le temps, dans le monde entier. La date et l'heure seront toujours exprimées dans le fuseau horaire de l'utilisateur. Par exemple, l'heure 2018-06-19T18:30:00 correspondra à 18:30:00 pour un utilisateur situé à New York, et également à 18:30:00 pour un utilisateur situé à Los Angeles. Cela s'avère utile lorsque la même date/heure doit s'appliquer à de nombreux emplacements physiques situés dans différents fuseaux horaires.