GameParticles
Date et heure

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 :

  • 0 correspond à 1970-01-01T00:00:00Z, l'epoch elle-même.
  • 1000000000 correspond à 2001-09-09T01:46:40Z, la milliardième seconde.
  • 1696118400 correspond à 2023-10-01T00:00:00Z.
  • 1791676800 correspond à 2026-10-11T00:00:00Z.
  • 2147483647 correspond à 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 +%s affiche le timestamp courant, et date -u -d @1696118400 en décode un sous Linux.
  • Python : datetime.fromtimestamp(1696118400, tz=timezone.utc) et int(dt.timestamp()).
  • JavaScript : new Date(1696118400 * 1000).toISOString() et Math.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.

Outils de ce guide

Questions fréquentes

Qu'est-ce qu'un timestamp Unix ?

C'est le nombre de secondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC, sans tenir compte des secondes intercalaires. La valeur 0 correspond à cet instant, et 1696118400 au 1er octobre 2023 à minuit UTC.

Comment savoir si un timestamp est en secondes ou en millisecondes ?

Comptez les chiffres. Les timestamps actuels comptent 10 chiffres en secondes et 13 en millisecondes. Si une date se décode en 1970 ou en l'an 50 000, vous n'avez pas la bonne unité.

Un timestamp Unix change-t-il selon le fuseau horaire ?

Non. Il désigne un instant unique dans le monde entier. Les fuseaux horaires n'interviennent que lorsque vous le convertissez en date du calendrier et en heure d'horloge pour l'affichage.

Qu'est-ce que le problème de l'an 2038 ?

Les systèmes qui stockent l'heure Unix dans un entier signé de 32 bits débordent à 2147483647, soit le 19 janvier 2038 à 03:14:07 UTC. Les systèmes modernes utilisent des valeurs de 64 bits et ne sont pas concernés.

Plus de guides sur la date et l'heure

Formateur JSON
Développeur · Formatez, validez et minifiez du JSON avec coloration syntaxique.
↵
Encoder / décoder en Base64
Développeur · Encodez un texte en Base64 ou décodez du Base64 en texte brut.
↵
Encodeur / Décodeur d'URL
Développeur · Encodez ou décodez des composants d'URL et des chaînes de requête.
↵
Générateur de hash
Développeur · Générez des hashs MD5, SHA-1, SHA-256 et SHA-512.
↵
Générateur d'UUID
Développeur · Générez des UUID v4 (aléatoires) en masse en un clic.
↵
Testeur de regex
Développeur · Testez des expressions régulières sur du texte avec surbrillance des correspondances en direct.
↵
Compteur de mots
Texte · Comptez les mots, caractères, phrases, paragraphes et le temps de lecture.
↵
Convertisseur de casse
Texte · Convertissez un texte en MAJUSCULES, minuscules, Titre, camelCase, snake_case, etc.
↵
Trieur de listes
Texte · Triez, inversez, dédoublonnez et mélangez des listes de texte.
↵
Aperçu Markdown
Texte · Écrivez du Markdown et voyez l'aperçu rendu en direct, côte à côte.
↵
Calculateur de pourcentage
Nombres · Calculez pourcentages, hausses, baisses et le % d'un nombre par rapport à un autre.
↵
Convertisseur de couleurs
Couleurs · Convertissez instantanément des couleurs entre HEX, RGB, HSL et HSV.
↵
Snake
Arcade · Mangez, grandissez, évitez les murs. Un classique indémodable.
↵
2048
Réflexion · Faites glisser les tuiles et fusionnez-les pour atteindre la légendaire tuile 2048.
↵
Word Grid
Réflexion · Devinez le mot caché de cinq lettres en six essais grâce aux indices de couleur.
↵
Sudoku
Réflexion · Remplissez la grille 9x9 par la logique. Quatre niveaux, de facile à expert.
↵
Démineur
Stratégie · Servez-vous des chiffres pour déminer le terrain. Logique classique, trois niveaux.
↵
Breakout
Arcade · Cassez toutes les briques avec la raquette et la balle. Bonus, combos, niveaux sans fin.
↵
Entraînement dactylo
Détente · Améliorez MPM et précision : exercices de 30 secondes à 5 minutes. Repérez vos touches faibles.
↵
TypeRunner
Arcade · Course de dactylographie multijoueur. Défiez vos amis par lien, battez l'ordinateur ou poursuivez votre fantôme.
↵
Typing Blocks
Arcade · Tapez chaque mot avant que son bloc de bois ne se pose. Ratez, et la pile grimpe vers la ligne.
↵
Bubble Shooter
Arcade · Visez, jouez avec les murs et éclatez des groupes de trois bulles ou plus.
↵
Road Rush
Arcade · Affrontez sept rivaux dans le trafic et prenez la tête à coups de poing.
↵