Convertisseur epoch

Le temps Unix, et pourquoi les dates atterrissent en 1970

Le temps Unix compte les secondes écoulées depuis le 1er janvier 1970 UTC. C'est un entier unique sans fuseau attaché, idéal pour le stockage et la comparaison — et une source courante d'erreurs d'un facteur mille.

Comment ça marche

• Convertit entre un horodatage entier et une date lisible, en UTC et dans votre fuseau local.
• Déduit l'unité de l'ordre de grandeur : 10 chiffres pour les secondes, 13 pour les millisecondes, 16 pour les microsecondes, 19 pour les nanosecondes.
• Ignore les secondes intercalaires, comme le temps Unix lui-même — un jour Unix fait toujours exactement 86 400 secondes.

secondes depuis 1970-01-01T00:00:00Z

1 000 000 000    →  2001-09-09   (10 chiffres, secondes)
1 700 000 000    →  2023-11-14   (10 chiffres, secondes)
1 700 000 000 000 →  2023-11-14  (13 chiffres, millisecondes)

2^31 − 1 = 2 147 483 647 → 2038-01-19T03:14:07Z

Exemple chiffré

Le bug classique : un horodatage JavaScript transmis à quelque chose qui attend des secondes.

1. Date.now() renvoie 1750000000000 — millisecondes, 13 chiffres
2. transmis à un système attendant des secondes, il est lu comme 1 750 000 000 000 secondes
3. soit environ l'an 57 442 — ou, si le champ déborde, 1970
4. le correctif : Math.floor(Date.now() / 1000) → 1750000000

Chaque fois qu'une date ressort en 1970 ou dans un futur absurde, la cause est presque toujours ce facteur 1 000. Comptez les chiffres avant de déboguer autre chose.

Lire le résultat

• Un horodatage n'a pas de fuseau. L'afficher en date locale est un choix de présentation ; l'entier stocké est toujours en UTC. Que deux utilisateurs voient des dates différentes pour le même horodatage est correct, pas un bug.
• Les systèmes stockant les secondes dans un entier 32 bits signé débordent le 19 janvier 2038. Tout ce qui a une longue durée de vie doit utiliser 64 bits.
• Les horodatages négatifs désignent des dates antérieures à 1970 et sont valides, mais leur traitement varie : certaines plateformes et bases les rejettent ou les gèrent mal.
• Les secondes intercalaires étant ignorées, le temps Unix n'est pas un vrai décompte de secondes SI depuis l'époque. Pour presque tout, cela n'a pas d'importance ; pour du chronométrage précis, utilisez une horloge monotone.

Questions fréquentes

Pourquoi ma date s'affiche-t-elle au 1er janvier 1970 ?

La valeur reçue par le convertisseur était zéro, nulle, ou une chaîne non analysée devenue zéro. Ce n'est presque jamais une vraie date de 1970 : vérifiez ce que votre code a réellement transmis.

Secondes ou millisecondes : comment savoir ?

Comptez les chiffres. Dix chiffres, ce sont des secondes, et la date tombera entre 2001 et 2286. Treize, des millisecondes. JavaScript utilise les millisecondes ; la plupart des outils Unix, bases et API utilisent les secondes.

Sources

• POSIX.1-2017 — Seconds Since the Epoch