Le timestamp Unix : comment il fonctionne et où les conversions dérapent
Des nombres comme 1795226400 apparaissent dans les journaux de serveur, les bases de données et les réponses d’API. Ce guide explique comment les lire, pourquoi le même nombre est juste à Paris comme à Montréal, et où les conversions se trompent le plus souvent.
Un compte de secondes depuis 1970
Un timestamp Unix est le nombre de secondes écoulées depuis l’epoch, le 1er janvier 1970 à 00:00:00 UTC. POSIX le définit par une formule de calendrier dans laquelle chaque jour compte exactement 86 400 secondes. Ainsi, 1795226400 correspond au 21 novembre 2026 à 02:00:00 UTC, soit 3 h du matin à Paris et 21 h la veille à Montréal. Les instants antérieurs à 1970 sont négatifs : -86400 est le 31 décembre 1969 à 00:00 UTC.
Comme c’est un simple entier, la différence entre deux timestamps donne directement l’intervalle en secondes, sans se soucier de la longueur des mois ni des années bissextiles.
Secondes ou millisecondes ?
Beaucoup de systèmes comptent en unités plus fines, et le nombre de chiffres les trahit. Pour toute date entre le 9 septembre 2001 et le 20 novembre 2286, un timestamp en secondes compte exactement 10 chiffres :
| Unité | 21/11/2026 02:00 UTC |
|---|---|
| Secondes (10 chiffres) | 1795226400 |
| Millisecondes (13 chiffres) | 1795226400000 |
| Microsecondes (16 chiffres) | 1795226400000000 |
| Nanosecondes (19 chiffres) | 1795226400000000000 |
Date.now() en JavaScript et System.currentTimeMillis() en Java renvoient des millisecondes ; time() en PHP renvoie des secondes. time.time() en Python renvoie des secondes avec une partie décimale, comme 1795226400.25, et UnixNano() en Go des nanosecondes. Des millisecondes lues comme des secondes tombent en l’an 58858, et des secondes lues comme des millisecondes tombent le 21 janvier 1970. Une date affichée en janvier 1970 signale presque toujours des unités inversées.
Un timestamp n’a pas de fuseau horaire
Un timestamp désigne le même instant partout sur Terre. Le fuseau n’intervient qu’au moment d’afficher cet instant en heure locale. 1795226400, c’est 3 h à Paris et à Bruxelles, 2 h à Dakar, 6 h à La Réunion le 21 novembre, et 21 h le 20 à Montréal. Le changement d’heure modifie deux fois par an le décalage de Paris par rapport à l’UTC (+01:00 en hiver, +02:00 en été), jamais le timestamp.
La règle pratique : stockez des timestamps ou de l’UTC, et ne convertissez dans le fuseau de l’utilisateur qu’à l’affichage. Utilisez les noms de fuseaux IANA, comme Europe/Paris ou America/Toronto, plutôt qu’un décalage fixe comme +1, pour que les règles d’heure d’été s’appliquent d’elles-mêmes.
Dans l’Union européenne, une directive de 2000 fait commencer l’heure d’été le dernier dimanche de mars et la fait finir le dernier dimanche d’octobre, à 1 heure du matin, temps universel. Le 29 mars 2026, les horloges françaises sont passées de 2 h à 3 h : une heure locale comme 2 h 30 n’a jamais existé ce jour-là, et les bibliothèques la traitent différemment, souvent en la décalant d’une heure sans prévenir. Le 25 octobre 2026, à l’inverse, la plage de 2 h à 3 h a eu lieu deux fois.
Méfiez-vous aussi des dates sans fuseau. En JavaScript, new Date('2026-11-21') est lu comme minuit UTC, alors que new Date('2026-11-21T09:00') est lu à l’heure locale de l’appareil.
Les secondes intercalaires
L’UTC ajoute parfois une seconde intercalaire pour rester proche de la rotation de la Terre. Il y en a eu 27 depuis 1972 ; la dernière a eu lieu le 31 décembre 2016 à 23:59:60 UTC. Le temps Unix les ignore, puisque chaque jour y compte 86 400 secondes : l’écart entre deux timestamps situés de part et d’autre de la fin de 2016 est plus court d’une seconde que le temps réellement écoulé. Pendant une seconde intercalaire, les systèmes répètent une seconde ou l’étalent ; les serveurs NTP publics de Google ralentissent leurs horloges sur 24 heures, de midi à midi UTC.
Aucune autre n’est prévue : le Bulletin C de l’IERS de juillet 2026 n’en annonce pas pour fin 2026, et la Conférence générale des poids et mesures a décidé en 2022 d’élargir l’écart toléré entre UT1 et UTC au plus tard en 2035.
Le bug de l’an 2038
Les systèmes anciens stockent le timestamp dans un entier signé de 32 bits, dont la valeur maximale, 2 147 483 647, tombe le 19 janvier 2038 à 03:14:07 UTC. Une seconde plus tard, la valeur repasse à −2 147 483 648, lu comme le 13 décembre 1901. Un entier non signé de 32 bits tient jusqu’au 7 février 2106, un entier de 64 bits bien au-delà.
La colonne TIMESTAMP de MySQL s’arrête au 2038-01-19 03:14:07 UTC, alors que DATETIME va jusqu’à l’an 9999. Et le problème n’attend pas 2038 : un crédit immobilier sur 20 ans signé aujourd’hui se termine en 2046, donc le logiciel qui calcule son échéancier a déjà franchi la limite.
Convertir dans les langages courants
JavaScript :
// maintenant
Math.floor(Date.now() / 1000)
const d = new Date(1795226400 * 1000);
d.toISOString();
// '2026-11-21T02:00:00.000Z'
d.toLocaleString('fr-FR',
{ timeZone: 'Europe/Paris' });
// '21/11/2026 03:00:00'
Date.parse('2026-11-21T03:00:00+01:00')
/ 1000; // 1795226400
Python 3.9 et suivants :
from datetime import datetime
from zoneinfo import ZoneInfo
paris = ZoneInfo('Europe/Paris')
datetime.fromtimestamp(1795226400, paris)
# 2026-11-21 03:00:00+01:00
dt = datetime(2026, 11, 21, 3, 0,
tzinfo=paris)
int(dt.timestamp()) # 1795226400
PHP, SQL et le terminal :
// PHP
$d = new DateTime('@1795226400');
$d->setTimezone(
new DateTimeZone('Europe/Paris'));
echo $d->format('c');
// 2026-11-21T03:00:00+01:00
-- PostgreSQL
SELECT to_timestamp(1795226400);
-- MySQL, fuseau de la session
SELECT FROM_UNIXTIME(1795226400);
date +%s # maintenant
date -u -d @1795226400 # Linux
date -u -r 1795226400 # macOS
Convertir sur swift.id
- Ouvrez le Convertisseur de timestamp Unix. En haut s’affichent le Timestamp Unix actuel (secondes) et sa valeur En millisecondes, chacun avec un bouton Copier.
- Collez un nombre dans Timestamp Unix. Avec l’unité sur Automatique, une valeur inférieure à 1011 est lue en secondes, inférieure à 1014 en millisecondes, inférieure à 1017 en microsecondes, et au-delà en nanosecondes. Choisissez l’unité vous-même si la déduction est fausse.
- Lisez le résultat en heure locale, en UTC, en ISO 8601, en RFC 2822 ou par rapport à maintenant, et copiez la ligne utile.
- Dans l’autre sens, remplissez la Date et l’Heure sous Date vers timestamp, puis choisissez le Fuseau horaire : France métropolitaine, Belgique, Suisse, Québec, Maroc, Sénégal et La Réunion figurent dans la liste. Si l’heure choisie tombe dans le trou ou le doublon d’un changement d’heure, l’outil le signale et indique l’instant retenu.
Des timestamps se cachent aussi dans les UUID version 7 ; le guide UUID v4 ou v7 montre comment en lire un.
Questions fréquentes
Pourquoi l’heure convertie est-elle décalée d’une ou deux heures ?
Un timestamp peut-il être négatif ?
JavaScript est-il concerné par le bug de 2038 ?
Date contient des millisecondes dans un nombre à virgule flottante de 64 bits et va jusqu’en l’an 275760. Le problème apparaît quand cette valeur part vers une colonne de base de données ou un autre programme encore en 32 bits.Une API doit-elle utiliser des timestamps ou des dates ISO 8601 ?
created_at_ms. Une date ISO 8601 doit porter son décalage, comme 2026-11-21T03:00:00+01:00, ou un Z final pour l’UTC.