Comprendre les horodatages Unix et les convertir
Pourquoi l’époque (epoch) compte, l’écueil secondes vs millisecondes qui continue à mordre les ingénieurs, et comment convertir n’importe quel timestamp en date lisible dans n’importe quel fuseau.
D’autres utilitaires qui complètent bien ce guide :
Pourquoi c’est important
Un ingénieur examine les logs pour comprendre pourquoi une alerte a sauté à « 1735689600 ». Est-ce le 2025-01-01 00:00:00 UTC (secondes) ou le 1970-01-21 02:08:09 (millisecondes interprétées comme secondes) ? Se tromper décale la chronologie du post-mortem de 55 ans. Les timestamps Unix excellent pour stocker et calculer mais sont mauvais pour les humains, tandis que la convention secondes vs millisecondes varie selon langages, bases et APIs. Un convertisseur fiable rend le choix explicite.
Trois scénarios réels
Collez 1735689600, le convertisseur affiche 2025-01-01 00:00:00 UTC et 2024-12-31 16:00:00 PST. Prenez le fuseau de l’utilisateur touché et continuez.
Triage incident plus rapide
Saisissez la date locale JST, copiez l’epoch résultant (en secondes ou millisecondes selon votre ordonnanceur).
Epoch correct dans le code
Collez une liste de valeurs epoch ; voyez les dates UTC décodées à côté ; recopiez dans votre tableur.
Rapport lisible
Parcours
Ouvrez le convertisseur d’horodatage Unix.
Coller un timestamp ou choisir une date
L’outil détecte secondes (10 chiffres, ~1973–2286) ou millisecondes (13 chiffres) automatiquement. Forcez via le menu déroulant si la valeur est atypique.
Lire la date décodée dans plusieurs fuseaux
UTC, fuseau du navigateur, et toute zone IANA personnalisée (
Asia/Tokyo,America/Sao_Paulo).Convertir dans l’autre sens
Saisissez date et heure dans une zone ; l’outil produit l’epoch en secondes et millisecondes.
Copier au format voulu
1735689600,1735689600000, ISO2025-01-01T00:00:00Z, RFC 2822 — selon ce qu’accepte votre cible.
Entrée
1735689600 (seconds)Décodé
UTC: 2025-01-01 00:00:00
ISO: 2025-01-01T00:00:00.000Z
Local: 2024-12-31 19:00:00 (UTC-5)Entrée
1735689600 (mistakenly read as milliseconds)Décodé comme ms
UTC: 1970-01-21 02:08:09.600
Conseils avancés
- Indiquez toujours l’unité dans vos contrats d’API. « Envoie-moi un timestamp Unix » est ambigu ; « entier Unix en millisecondes » ne l’est plus.
- Traitez les timestamps négatifs comme valides pour les dates avant le 1970-01-01 — l’outil les accepte et affiche la date grégorienne correcte.
- Pour l’affichage humain, préférez ISO-8601.
2026-04-22T15:30:00Zest sans ambiguïté et se trie lexicographiquement. - Conversion par lots : collez une valeur par ligne pour une colonne entière.
Pièges courants
Piège courant
Surprises DST après conversion de fuseau
Un rendez-vous à 9 h Pacifique en octobre n’est pas le même qu’en novembre : PDT vs PST. Convertissez avec la zone IANA (America/Los_Angeles), pas un offset fixe (UTC-8), et l’outil gère l’heure d’été.
Piège courant
Date.getTime() en JS vs time.time() en Python
JS renvoie des millisecondes ; Python des secondes avec fraction. En portant du code, multipliez ou divisez par 1000 explicitement. L’outil accepte les deux formats pour repérer l’écart.
Piège courant
Problème de l’an 2038
Certains systèmes stockent l’heure Unix en entier 32 bits signé. Au-delà de 2147483647 (2038-01-19), débordement. Si vous maintenez ce genre de système, planifiez une migration 64 bits.
Quand ce n’est pas l’outil adapté
- Calculs en jours ouvrés (ex. « dans 5 jours ouvrés »). Une lib comme
date-fns-business-daysou le calendrier métier. - Débogage d’expressions cron — un évaluateur cron qui liste les N prochains déclenchements.
- Événements récurrents calendaires (RRULE) — parseurs iCalendar, pas un convertisseur à secondes plates.
FAQ
Dans quel fuseau est « zéro epoch » ?
0, c’est 1970-01-01 00:00:00 UTC. L’epoch Unix est définie implicitement en UTC.
Pourquoi les dates sautent d’une heure deux fois par an ?
C’est le passage à l’heure d’été. La base de zones IANA suit les règles régionales et l’outil les applique automatiquement.
Mon entrée part-elle sur un serveur ?
Non. La conversion utilise Date du navigateur et Intl.DateTimeFormat ; rien ne quitte la page.
Étapes suivantes
- Repérez des fenêtres de réunion entre équipes avec l’outil comparateur de fuseaux.
- Ajoutez une horloge personnelle pour vos villes sur /time-tools/world-clock.
- Vérifiez les jours fériés de la région avec l’outil Jours fériés du jour.