Comprendre les timestamps Unix
Les timestamps Unix paraissent simples car ce ne sont que des nombres, mais ils apparaissent à peu près partout dans le travail web. APIs, logs, exports, messages de files et enregistrements d'événements en dépendent tous. Le format est un seul entier comptant des secondes (ou millisecondes) depuis le 1er janvier 1970 UTC.
L'avantage est la cohérence. Un timestamp est compact, neutre vis-à-vis du fuseau au niveau du stockage et facile à comparer, trier ou transmettre pour les logiciels. Le défi : ce format n'est pas lisible en l'état. Une valeur comme 1710153600 ne dit rien tant qu'elle n'est pas convertie en date.
C'est pourquoi les outils de timestamps restent utiles même pour des devs expérimentés. Il faut souvent répondre vite à des questions pratiques : cette valeur est-elle en secondes ou millisecondes ? Quelle date représente-t-elle en UTC et en heure locale ? Quel timestamp correspond à une date précise pour une requête de test ?
Quand c'est utile
- Examiner des réponses d'API qui renvoient des champs temporels numériques comme
created_atouexpires_at. - Consulter des logs où les temps d'événements sont stockés en valeurs Unix brutes.
- Déboguer les questions de fuseau entre un service backend et le navigateur.
- Convertir une date humaine en temps Unix avant de tester une requête ou une charge utile.
Exemple pratique
Imaginez qu'une API envoie 1710153600 dans une charge utile JSON. À première vue, ce nombre n'apprend pas grand-chose, mais en le convertissant on voit qu'il correspond à une date UTC précise et à une date locale dans votre fuseau. Cela révèle aussitôt si la valeur est plausible ou décalée de quelques heures, de jours, voire d'un facteur mille.
C'est aussi là que les millisecondes comptent. Une valeur comme 1710153600000 représente le même instant, mais en millisecondes au lieu de secondes. Si vous prenez l'une pour l'autre, la date sera complètement fausse.
Cas d'usage courants
- Vérifier si un champ de timestamp dans une charge utile est en secondes ou millisecondes.
- Comparer l'heure d'un événement en UTC avec ce que les utilisateurs voient en heure locale.
- Créer des valeurs d'expiration d'exemple pour des tests et des démos.
- Vérifier que les codes backend et frontend convertissent de la même façon.
- Lire d'anciennes données exportées sans ouvrir de console ou de script séparé.
Utilisez le convertisseur dans le navigateur
Utilisez l'outil dans le navigateur pour l'appliquer en quelques secondes.
FAQ
Pourquoi les timestamps utilisent-ils UTC ?
UTC donne au logiciel un point de référence stable. La version locale lisible peut changer selon le fuseau, mais le timestamp stocké, non.
Pourquoi certains timestamps ont-ils 10 chiffres et d'autres 13 ?
Dix chiffres correspondent généralement à des secondes. Treize chiffres correspondent généralement à des millisecondes.
Ai-je toujours besoin à la fois d'UTC et de l'heure locale ?
En général oui, en phase de débogage. UTC aide à comparer les systèmes, l'heure locale aide à vérifier ce qu'une personne a vraiment vu.