Lire les timestamps des journaux et des API
Les journaux, bases de données, champs d'expiration des JWT et réponses d'API enregistrent le temps en secondes (ou millisecondes) écoulées depuis le 1er janvier 1970 UTC. Collez-en un pour voir la date correspondante en UTC et dans votre fuseau ; l'unité est déduite du nombre de chiffres, si bien que 1730000000 et 1730000000000 sortent tous deux justes.
Fuseaux horaires et limite de 2038
Un timestamp n'a pas de fuseau : c'est le même instant partout, seul son affichage change. Choisissez n'importe quel fuseau pour voir l'heure locale, heure d'été comprise (Paris est à UTC+1 l'hiver, UTC+2 l'été), et copiez la forme ISO 8601 pour le code. Les systèmes qui stockent les timestamps en entiers signés de 32 bits s'arrêtent le 19 janvier 2038 à 03:14:07 UTC ; sur 64 bits, il n'y a pas cette limite.
Les timestamps dans les API
Les API REST utilisent couramment des timestamps Unix plutôt que des chaînes de date formatées car ils sont indépendants des fuseaux horaires, non ambigus, compacts et faciles à comparer mathématiquement. Un timestamp comme 1742045400 signifie exactement la même chose, peu importe où se trouvent le serveur ou le client.
Certaines API utilisent les secondes (standard Unix), d'autres les millisecondes (standard JavaScript). Vérifiez toujours la documentation de l'API. Un moyen rapide de distinguer : 10 chiffres = secondes, 13 chiffres = millisecondes.
Fuseaux horaires et UTC : la source de bugs
Les bugs liés aux fuseaux horaires comptent parmi les plus courants en développement logiciel. Un timestamp stocké en UTC est absolu, mais l'afficher dans le fuseau local d'un utilisateur nécessite de connaître son décalage — qui change avec l'heure d'été.
Bonne pratique : stockez toujours les timestamps en UTC (ou en timestamps Unix), et ne convertissez en heure locale que pour l'affichage. Ne stockez jamais d'heures locales sans information de fuseau horaire.
Exemples de code
Obtenir le timestamp actuel : JavaScript — Date.now() retourne des millisecondes, utilisez Math.floor(Date.now()/1000) pour les secondes. Python — time.time() retourne un float en secondes. PHP — time() retourne les secondes. Java — System.currentTimeMillis() retourne les millisecondes.
Convertir un timestamp en date : JavaScript — new Date(timestamp * 1000). Python — datetime.fromtimestamp(timestamp). PHP — date('Y-m-d H:i:s', timestamp). SQL — FROM_UNIXTIME(timestamp) en MySQL, to_timestamp(timestamp) en PostgreSQL.