Convertisseur de timestamp Unix

Le temps Unix compte les secondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC, sans tenir compte des secondes intercalaires. C’est le format de la plupart des lignes de log, des dates d’expiration de jetons, des colonnes de base de données et des champs d’API, et il est illisible tant qu’on ne l’a pas converti. Cet outil passe d’un timestamp à une date et inversement, en affichant simultanément le résultat dans votre fuseau horaire local, en UTC et au format ISO 8601.

Comment ça marche

En mode Timestamp → Date, saisissez un nombre et indiquez s’il est exprimé en secondes ou en millisecondes. L’outil multiplie les secondes par 1 000, construit un objet Date JavaScript et en affiche trois rendus : la date et l’heure locales de votre navigateur, le même instant en UTC, et la chaîne ISO 8601 terminée par Z. Le bouton Copier place la forme ISO dans le presse-papiers, car c’est celle que les autres systèmes interprètent sans ambiguïté. Maintenant insère l’heure actuelle dans l’unité sélectionnée.

En mode Date → Timestamp, choisissez une date et une heure avec le sélecteur du navigateur. La valeur est interprétée dans votre fuseau horaire local, convertie en millisecondes depuis l’epoch, puis affichée à la fois en secondes entières (arrondies à l’inférieur) et en millisecondes.

Tout s’exécute localement. Le rendu local dépend du fuseau horaire de votre appareil, si bien que deux personnes qui convertissent le même nombre peuvent voir des heures différentes ; les lignes UTC et ISO, elles, sont identiques pour tout le monde.

Secondes, millisecondes et au-delà

Pour toute date contemporaine, un nombre à dix chiffres est en secondes et un nombre à treize chiffres en millisecondes. Si la date convertie tombe en 1970 ou dans un futur lointain, vous vous êtes très probablement trompé d’unité. System.currentTimeMillis() en Java, Date.now() en JavaScript et la plupart des API JSON utilisent des millisecondes ; les outils POSIX, les claims JWT et de nombreuses bases de données utilisent des secondes.

Les valeurs à seize chiffres sont des microsecondes et celles à dix-neuf chiffres des nanosecondes, que certains systèmes de tracing et de métriques produisent. L’outil ne propose pas ces unités : divisez d’abord par 1 000 ou par 1 000 000. Les fractions de seconde sont acceptées en entrée et apparaissent dans la sortie ISO à la milliseconde près, ce qui correspond à la précision d’un objet Date JavaScript.

Les timestamps négatifs sont valides et désignent des dates antérieures à 1970. La plage représentable couvre environ ±273 000 ans de part et d’autre de l’epoch, ce qui dépasse largement n’importe quelle donnée réelle.

Fuseaux horaires et heure d’été

Un timestamp Unix n’a pas de fuseau horaire : il désigne un instant. Le fuseau n’intervient que lorsque vous transformez cet instant en date du calendrier, et c’est pourquoi l’outil affiche l’heure locale et l’heure UTC côte à côte. Quand une entrée de log semble décalée d’une heure, c’est généralement que l’émetteur a horodaté en heure locale alors que le lecteur l’a lue comme de l’UTC, ou qu’un changement d’heure est intervenu entre les deux.

C’est dans le sens date → timestamp que l’ambiguïté s’installe. Pendant l’heure qui se répète lors du passage à l’heure d’hiver, une même heure locale correspond à deux instants, et le navigateur en choisit un. Si vous avez besoin de ce niveau de précision, travaillez en UTC et convertissez avec une vraie bibliothèque plutôt qu’avec un sélecteur de date.

Équivalent en ligne de commande

La commande date de GNU convertit dans les deux sens :

date -u -d @1700000000              # Tue Nov 14 22:13:20 UTC 2023
date +%s                            # current Unix time in seconds
date -d '2024-03-01T09:00:00Z' +%s  # ISO string to seconds

Sous macOS, la première forme s’écrit date -r 1700000000.

L’an 2038

Les systèmes qui stockent le temps Unix dans un entier signé de 32 bits débordent le 19 janvier 2038 à 03:14:07 UTC. Les systèmes d’exploitation et les langages modernes utilisent 64 bits, mais ce n’est pas le cas des systèmes embarqués, des anciens formats de fichiers ni de certains schémas de base de données. Si vous concevez un stockage aujourd’hui, utilisez un entier de 64 bits ou un véritable type timestamp.

Pour aller plus loin

Le package java.time de Java modélise directement cette distinction : Instant est le timestamp, ZonedDateTime est l’instant associé à un fuseau, et LocalDateTime est une date-heure d’horloge, sans aucun fuseau. Le guide consacré à Optional et à l’API java.time explique lequel utiliser dans quel cas et comment passer de l’un à l’autre en toute sécurité. Les claims exp et iat que vous voyez dans le décodeur JWT sont des secondes Unix, et le calculateur d’âge se charge de l’arithmétique calendaire une fois que vous avez une date.