timestampinfo.fr
Outils & documentation

LA DOCUMENTATION DU TEMPS

Comprendre le format ISO 8601

Une notation commune pour échanger des dates et des heures, à condition de préciser leur contexte.

Décomposer une date

2024-04-01T14:00:00+02:00 se lit : le 1er avril 2024, à 14 heures, avec un décalage de deux heures par rapport à UTC. La lettre T sépare la date de l’heure ; Z peut remplacer +00:00 pour désigner UTC.

Une chaîne sans fuseau n’identifie pas toujours un instant

2024-04-01 est une date de calendrier. 2024-04-01T14:00:00 est une date et heure sans décalage. Sans convention supplémentaire, ces chaînes ne suffisent pas à identifier un instant universel.

Fraction de seconde

2024-04-01T12:00:00.123Z ajoute 123 millisecondes. Les limites de précision dépendent de la bibliothèque : JavaScript Date conserve les millisecondes, tandis que Python datetime peut conserver les microsecondes.

ISO 8601 et les API

ISO 8601 comprend plusieurs représentations, dont des dates calendaires, des dates par semaine et des durées. Les API utilisent fréquemment un sous-ensemble proche de RFC 3339. Vérifiez le contrat de votre API plutôt que de supposer que toutes les formes sont prises en charge.

Tester une date ISO

Références

RFC 3339 — dates et heures sur Internet

Ouvrir le convertisseur