timestampinfo.fr
Outils & documentation

LA DOCUMENTATION DU TEMPS

Comprendre le timestamp Unix et l’Epoch

Origine, unités, conversion et comparaison : les bases pour manipuler un instant correctement.

Ce que représente un timestamp

Un horodatage identifie une date et une heure selon une convention. Le temps Unix compte les secondes depuis le 1er janvier 1970 à 00:00:00 UTC, sans compter les secondes intercalaires. Avant cette origine, les valeurs sont négatives.

0           → 1970-01-01T00:00:00Z
-1          → 1969-12-31T23:59:59Z
1711972800  → 2024-04-01T12:00:00Z

Récupérer le timestamp courant

JavaScript fournit Date.now() en millisecondes. PHP fournit time() en secondes. Python fournit time.time() en secondes avec une fraction. Le nombre doit toujours être accompagné de sa convention d’unité.

Un instant ne possède pas un fuseau d’affichage unique

Le même timestamp s’affiche à des heures différentes selon le fuseau choisi. Changer le fuseau d’affichage ne modifie pas l’instant. À l’inverse, interpréter une heure locale sans connaître le fuseau peut produire le mauvais instant.

Comparer et calculer

Une comparaison numérique n’a de sens que si les deux valeurs partagent la même origine et la même unité. Pour une durée, soustrayez le départ à la fin. Divisez une différence en secondes par 3 600 pour obtenir des heures ; ne confondez pas cette durée avec une heure de la journée.

Calculer une différence de timestamps

Convertir des millisecondes en secondes

Divisez les millisecondes par 1 000. Garder la fraction conserve la précision : 1711972800123 ms devient 1711972800.123 s. Arrondir ou tronquer à un entier supprime cette fraction ; diviser seul ne la supprime pas.

Récupérer l’horodatage d’un fichier

En Python, os.stat(chemin).st_mtime donne le timestamp de modification en secondes. Convertissez-le avec datetime.fromtimestamp(valeur, timezone.utc) pour obtenir UTC. Il s’agit de la modification du fichier, pas d’une preuve de création ou d’authenticité.

Un timestamp n’est pas une preuve ni un identifiant unique

Deux événements peuvent avoir la même valeur, et l’horloge peut être corrigée. Un horodatage seul ne garantit ni l’ordre causal, ni l’authenticité, ni l’unicité d’un événement. Un système de signature ou d’horodatage certifié répond à d’autres exigences.

Références

Documentation de référence

Ouvrir le convertisseur