1735689600 ne veut rien dire tant qu'on ne sait pas que c'est un timestamp Unix : le nombre de secondes écoulées depuis le 1er janvier 1970 à 00:00:00 UTC (l'"epoch"). C'est le format de date le plus utilisé dans les bases de données, les API et les JWT — et aussi la source d'un des bugs les plus répandus en JavaScript.
Le bug des trois zéros
Unix compte en secondes. JavaScript, lui, construit les dates à partir de millisecondes :
new Date(1735689600) // ❌ 1970-01-21 — 50 ans d'écart !
new Date(1735689600 * 1000) // ✅ 2025-01-01
Si votre API renvoie des secondes (comme presque tout ce qui n'est pas JavaScript : Python, PHP, SQL) et que vous passez ce nombre directement à new Date(), vous obtenez une date de 1970. Multipliez par 1000 — ou, si la valeur est déjà en millisecondes, ne multipliez pas — l'erreur va presque toujours dans ce sens.
Pourquoi UTC et pas votre heure locale
Un timestamp Unix n'a pas de fuseau horaire : c'est un compteur absolu de secondes, identique à Madrid comme à Tokyo. Le fuseau horaire n'intervient qu'au moment de l'affichage — c'est pourquoi deux serveurs sur des continents différents peuvent comparer des timestamps directement sans problème, et pourquoi c'est le format préféré pour created_at, le exp d'un JWT, ou des clés de cache.
Le problème de l'an 2038
Les systèmes qui stockent encore le timestamp dans un entier signé sur 32 bits manquent de nombres le 19 janvier 2038 (le fameux bug Y2038). C'est le même type de bug que le bug de l'an 2000, mais il touche les systèmes embarqués, les vieilles bases de données et quelques time_t en C jamais migrés vers 64 bits. Si vous travaillez dans l'IoT ou le firmware, vous devriez déjà vérifier ce point.
Comment s'éviter le problème
Convertissez dans les deux sens avec le convertisseur de timestamp Unix : collez le nombre pour voir la date dans votre fuseau horaire et en UTC, ou l'inverse — choisissez une date et obtenez le timestamp exact. Si vous devez comparer la même heure dans plusieurs villes, utilisez le convertisseur de fuseaux horaires ; et si vous voulez calculer le nombre de jours entre deux dates (pas des timestamps), le calculateur de différence de dates fait le calcul sans que vous ayez à soustraire des timestamps à la main.