Horodatages Unix : secondes, millisecondes et affichage local
Comprenez le nombre avant de l’utiliser dans un export, un journal technique ou une intégration.
Un nombre représentant un instant
Un horodatage Unix classique compte les secondes par rapport au 1er janvier 1970 à 00:00:00 UTC, selon la convention Unix du système. Ce n’est pas une heure locale et il ne contient aucun nom de ville. Le même horodatage affiché à Tokyo et à Londres donne des heures locales différentes pour un instant identique. Notre convertisseur d’horodatages aide à examiner une valeur, après identification de l’unité attendue par le système d’origine.
Ne pas confondre secondes et millisecondes
De nombreuses interfaces utilisent les secondes, tandis que les valeurs Date de JavaScript utilisent les millisecondes. Les confondre peut produire une date proche de l’origine Unix ou très éloignée de la période voulue. Ne vous fiez pas uniquement au nombre de chiffres : consultez la documentation du champ, puis testez une valeur connue. Gardez la précision fractionnaire lorsqu’elle compte et évitez d’arrondir silencieusement un horodatage précis avant de classer des événements.
Conserver séparément le programme local
Un horodatage identifie un événement terminé ou une échéance unique, mais ne décrit pas complètement « chaque lundi à 09:00 à Paris ». Cette instruction nécessite un horaire local et les règles du fuseau. De même, une date de naissance ou un jour férié entier est une date civile, pas forcément un instant à minuit UTC. Une mauvaise représentation peut déplacer le jour affiché lorsque le logiciel convertit vers une autre région.
Une méthode fiable de diagnostic
Notez la valeur brute, son unité, l’instant UTC attendu et le lieu utilisé pour l’affichage. Comparez d’abord UTC, puis la conversion locale. Si UTC est faux, examinez les unités ou l’interprétation des données ; s’il concorde mais pas l’affichage local, vérifiez les réglages et versions de fuseaux. Conservez les journaux originaux en corrigeant la présentation. Le guide des données explique les changements de règles et le guide UTC propose un format lisible pour partager le diagnostic.