Si vous ouvrez un fichier de log, une réponse d'API ou une table SQL et tombez sur une colonne pleine de nombres à 10 ou 13 chiffres, il s'agit presque toujours d'un timestamp Unix (epoch). Ce guide explique comment le lire, comment repérer l'unité (secondes ou millisecondes), gérer l'UTC et convertir des lots entiers de valeurs d'un coup.
Qu'est-ce qu'un timestamp Unix ?
Réponse courteUn timestamp Unix (epoch) est le nombre de secondes (ou millisecondes) écoulées depuis le 1er janvier 1970, 00:00:00 UTC. C'est un simple compteur, indépendant du calendrier et du fuseau horaire, ce qui le rend pratique pour stocker un instant précis dans une base de données ou un fichier de log.
Contrairement à une date écrite en toutes lettres, un epoch ne dépend d'aucune convention régionale : pas de format jour/mois vs mois/jour, pas d'ambiguïté sur le fuseau. C'est pour cette raison que la quasi-totalité des systèmes d'exploitation, langages de programmation et bases de données l'utilisent en interne pour représenter le temps, avant de le convertir en date lisible uniquement au moment de l'affichage.
Épithète « epoch » désigne à la fois le point de départ (1er janvier 1970 UTC) et, par extension, la valeur numérique elle-même. Les deux termes « timestamp Unix » et « temps epoch » sont interchangeables dans la pratique.
Secondes ou millisecondes : comment les distinguer
Réponse courteComptez les chiffres : environ 10 chiffres = secondes, 13 chiffres = millisecondes (1000 fois la valeur en secondes). Certaines API renvoient aussi des microsecondes (16 chiffres) ou des nanosecondes (19 chiffres).
C'est une source d'erreur très fréquente : passer une valeur en millisecondes à une fonction qui attend des secondes (ou l'inverse) donne une date complètement fausse, souvent projetée des décennies dans le passé ou le futur. Le convertisseur de timestamp Unix de ToolPico détecte automatiquement l'unité selon le nombre de chiffres saisis, mais vous pouvez aussi la forcer manuellement si besoin.
| Valeur epoch (exemple) | Chiffres | Unité | Date correspondante (UTC) |
|---|
1753776000 | 10 | Secondes | 29 juil. 2025, 08:00:00 |
1753776000000 | 13 | Millisecondes | 29 juil. 2025, 08:00:00 |
1753776000000000 | 16 | Microsecondes | 29 juil. 2025, 08:00:00 |
Exemple illustratif uniquement — utilisez l'onglet « Epoch → Date » de l'outil pour vérifier une valeur réelle.
UTC, fuseau local et fuseau personnalisé
Réponse courteL'epoch lui-même est toujours relatif à l'UTC. Ce qui change, c'est uniquement l'affichage : choisissez « UTC » pour le temps universel, « Local » pour le fuseau de votre navigateur, ou un fuseau nommé IANA (par ex. Europe/Paris) pour une ville précise, avec prise en compte automatique de l'heure d'été.
Cette distinction est essentielle pour déboguer un incident réparti sur plusieurs équipes ou fuseaux : deux personnes qui regardent le même epoch dans deux fuseaux différents verront deux heures locales différentes, alors qu'il s'agit du même instant exact. Le convertisseur propose les deux options — UTC brut et fuseau nommé IANA — pour éviter toute confusion, ainsi qu'un format de sortie ISO-8601 qui inclut explicitement le décalage.
Conversion en masse et bug de l'an 2038
Réponse courtePour convertir une longue liste de timestamps (extraits d'un log par exemple), collez-les un par ligne dans l'onglet « Masse » : l'outil traite la liste entière d'un coup avec un bouton de copie par ligne. Et gardez en tête le
bug de l'an 2038, qui touche les anciens systèmes 32 bits après le 19 janvier 2038, 03:14:07 UTC.
Ce bug se produit parce que certains systèmes historiques stockent l'epoch sous forme d'entier signé sur 32 bits, qui déborde à cette date précise et fait basculer la date calculée vers 1901. Les systèmes modernes en 64 bits ne sont pas concernés, mais le cas reste pertinent lors de l'analyse de code ou de matériel ancien. Pour un usage pratique, un mini-outil « Plage de dates en epoch » permet aussi de générer les bornes de début/fin de journée, de mois ou d'année — utile pour construire une requête SQL de type WHERE ts BETWEEN debut_jour AND fin_jour.
Convertissez un epoch en date (ou l'inverse), en masse, avec fuseau UTC/local — gratuit et entièrement dans votre navigateur.
Essayer l'outil →
Questions fréquentes
Qu'est-ce qu'un timestamp Unix (epoch) ?
Un timestamp Unix (ou epoch) est le nombre de secondes écoulées depuis le 1er janvier 1970, 00:00:00 UTC. C'est un simple nombre, indépendant du fuseau horaire et des particularités du calendrier, ce qui en fait un format universel pour stocker un instant précis dans les bases de données, les API et les journaux (logs).
Comment savoir si un timestamp est en secondes ou en millisecondes ?
Comptez ses chiffres : un epoch en secondes fait environ 10 chiffres (par exemple 1753776000), tandis qu'un epoch en millisecondes en fait 13 (1753776000000), soit mille fois la valeur en secondes. Le convertisseur de timestamp Unix de ToolPico détecte automatiquement l'unité selon le nombre de chiffres saisis.
Comment convertir un epoch en date lisible ?
Collez la valeur epoch dans l'onglet « Epoch → Date » de l'outil, choisissez le fuseau horaire souhaité (UTC, local ou personnalisé), et la date-heure lisible s'affiche instantanément, avec les formats ISO-8601 et RFC 2822 prêts à copier.
Qu'est-ce que le bug de l'an 2038 ?
Le bug de l'an 2038 (Y2038) touche les anciens systèmes qui stockent l'epoch sur un entier signé 32 bits : ce compteur déborde après le 19 janvier 2038, 03:14:07 UTC, et la date bascule brutalement vers 1901. Les systèmes 64 bits modernes ne sont pas concernés.
Peut-on convertir plusieurs timestamps d'un coup ?
Oui : l'onglet « Masse » du convertisseur accepte une liste de valeurs (une par ligne), epoch ou date selon la direction choisie, et convertit toute la liste en un seul clic, avec un bouton de copie à côté de chaque résultat.
Note méthodologique : les exemples numériques de cet article sont illustratifs et servent uniquement à expliquer la mécanique de conversion ; utilisez toujours l'outil pour obtenir une valeur exacte à l'instant présent. Contenu fourni à titre informatif, sans garantie d'exhaustivité technique pour tous les systèmes existants.