Les timestamps Unix expliqués : secondes, millisecondes et fuseaux horaires
Ce qu'est un timestamp Unix, distinguer secondes et millisecondes, pourquoi les fuseaux ne le changent pas, le problème de 2038 et les conversions en code.
Mis à jour
Un timestamp Unix est un décompte des secondes écoulées depuis l'epoch Unix, le 1er janvier 1970 à 00:00:00 UTC. 1696118400 signifie 1 696 118 400 secondes après cet instant, soit minuit UTC le 1er octobre 2023. C'est le même nombre dans tous les pays, car le fuseau horaire n'intervient que lorsque vous transformez ce décompte en date du calendrier lisible par un humain.
Pourquoi les ordinateurs comptent les secondes
Les dates sont pénibles à stocker et à comparer. Les mois n'ont pas tous la même longueur, les années comptent parfois 366 jours, et chaque région écrit les éléments dans un ordre différent. Un simple entier évite tout cela. Deux timestamps peuvent être comparés avec un signe inférieur, soustraits pour obtenir une durée, triés comme de simples nombres et stockés dans un nombre fixe d'octets.
C'est pourquoi les bases de données, les fichiers journaux, les jetons JWT, les en-têtes de cache et la plupart des API échangent l'heure sous la forme d'une valeur epoch. Quelques repères vous aident à en reconnaître une quand vous en voyez :
0correspond à 1970-01-01T00:00:00Z, l'epoch elle-même.1000000000correspond à 2001-09-09T01:46:40Z, la milliardième seconde.1696118400correspond à 2023-10-01T00:00:00Z.1791676800correspond à 2026-10-11T00:00:00Z.2147483647correspond à 2038-01-19T03:14:07Z, la limite des 32 bits.
Les valeurs négatives sont autorisées et désignent des dates antérieures à 1970, même si tous les systèmes ne les gèrent pas.
Secondes ou millisecondes
La définition d'origine compte les secondes, et c'est ce que renvoient les outils Unix, time.time() en Python et la plupart des bases de données. JavaScript a rompu avec la convention. Date.now() renvoie des millisecondes : le même instant apparaît donc sous la forme 1696118400000. System.currentTimeMillis() en Java et de nombreux frameworks de journalisation suivent JavaScript.
Mélanger les deux est le bug de timestamp le plus courant. Passez une valeur en millisecondes là où des secondes sont attendues, et la date atterrit autour de l'an 55 000. Passez des secondes là où des millisecondes sont attendues, et toutes les dates deviennent le 20 janvier 1970. La vérification rapide, c'est le nombre de chiffres : les valeurs actuelles comptent 10 chiffres en secondes et 13 en millisecondes. Certains systèmes vont plus loin, avec 16 chiffres pour les microsecondes et 19 pour les nanosecondes.
La conversion est une multiplication ou une division par 1000. En JavaScript, les secondes s'obtiennent avec Math.floor(Date.now() / 1000), et une valeur en secondes devient une date avec new Date(ts * 1000). Le convertisseur de timestamp Unix détecte automatiquement l'unité d'après la longueur et affiche la date décodée à côté de sa forme ISO 8601, ce qui vous évite de deviner.
Les fuseaux horaires ne changent pas le nombre
Un timestamp désigne un instant, pas une heure d'horloge. 1696118400 correspond à minuit le 1er octobre à Londres, mais à 20:00 le 30 septembre à New York, à 05:30 le 1er octobre à Mumbai et à 09:00 le 1er octobre à Tokyo. Les quatre sont le même instant et le même nombre. Seul l'affichage diffère.
C'est pourquoi la règle de bon sens pour tout système est la suivante : stockez et transmettez les timestamps en UTC, et convertissez en heure locale au dernier moment possible, dans l'interface utilisateur. Si vous stockez plutôt une heure locale, vous perdez l'instant. « 2 h 30 le 5 novembre » se produit deux fois à New York quand les horloges reculent, et jamais à la date de printemps où elles avancent d'une heure.
L'heure d'été est la principale raison d'éviter les calculs en heure locale. Ajouter 86400 secondes à un timestamp fait toujours avancer d'exactement un jour de temps réel, mais ce jour peut durer 23 ou 25 heures sur l'horloge locale. Si vous avez besoin de « la même heure demain » dans le fuseau d'un utilisateur, faites le calcul en termes de calendrier avec une bibliothèque qui gère les fuseaux horaires, pas en ajoutant des secondes.
Quand vous avez besoin de voir à quoi correspond un instant donné d'un bureau à l'autre, le convertisseur de fuseaux horaires prend une date et une heure et liste l'équivalent dans plus de 30 fuseaux, ce qui est plus rapide que de raisonner à la main sur les décalages.
Les secondes intercalaires et la limite de 2038
L'heure Unix fait comme si chaque jour comptait exactement 86400 secondes. Les jours réels comportent parfois une seconde intercalaire, et lorsque cela se produit, l'horloge système répète ou étire une seconde au lieu de compter jusqu'à 60. Pour presque toutes les applications, c'est invisible, mais c'est la raison pour laquelle l'heure Unix n'est pas tout à fait égale au nombre de secondes réelles écoulées depuis 1970.
Le problème de 2038 est plus concret. Un entier signé de 32 bits plafonne à 2147483647. Une seconde plus tard, le 19 janvier 2038 à 03:14:08 UTC, il bascule sur un grand nombre négatif, qui se décode en décembre 1901. Les systèmes d'exploitation, les langages et les bases de données modernes utilisent des valeurs de 64 bits et sont tranquilles pour les 292 prochains milliards d'années. Le risque se situe dans les vieux appareils embarqués, les anciens formats de fichiers et tout schéma ayant choisi INT au lieu de BIGINT pour une colonne epoch.
Manipuler les timestamps dans le code
Les conversions sont intégrées à tous les langages, mais la forme diffère :
- Shell :
date +%saffiche le timestamp courant, etdate -u -d @1696118400en décode un sous Linux. - Python :
datetime.fromtimestamp(1696118400, tz=timezone.utc)etint(dt.timestamp()). - JavaScript :
new Date(1696118400 * 1000).toISOString()etMath.floor(date.getTime() / 1000). - SQL :
to_timestamp(1696118400)dans PostgreSQL,FROM_UNIXTIME(1696118400)dans MySQL. - Excel :
=A1/86400 + DATE(1970,1,1)transforme une valeur en secondes en numéro de série de date.
Les durées ne sont qu'une soustraction. Les deux timestamps 1696118400 et 1696204800 diffèrent de 86400, soit un jour. Divisez par 3600 pour obtenir des heures ou par 604800 pour des semaines. Quand le résultat doit être exprimé en unités de calendrier, comme « 2 ans, 3 mois et 14 jours », la simple soustraction ne suffit plus, car la longueur des mois varie. Le calculateur de durée réalise cette décomposition à partir de deux dates et affiche aussi les totaux en jours, en heures et en secondes.
D'autres convertisseurs pour les dates, les expressions cron et les planifications se trouvent dans la catégorie date et heure.
Essayez
Collez 1696118400 dans le convertisseur de timestamp Unix pour voir le 1er octobre 2023 en UTC, puis collez 1696118400000 et vérifiez qu'il détecte les millisecondes et aboutit au même instant.