Convertisseur temps Unix

Un convertisseur de temps Unix transforme cet entier en une date de calendrier et une heure d’horloge qu’un humain peut lire : année, mois, jour, heure, minute et seconde, toujours en UTC. Cet outil accepte un timestamp entier fini en secondes, le découpe en un indice de jour UTC et une heure du jour par division entière vers le bas, projette l’indice sur le calendrier grégorien proleptique avec l’arithmétique civil-from-days publiée, et renvoie une chaîne date-heure UTC déterministe de la forme YYYY-MM-DDTHH:mm:ssZ. Les entiers négatifs sont de première classe : ils encodent des instants antérieurs à l’epoch, tel le 31 décembre 1969.

Ce que le temps Unix compte et comment le calendrier UTC est retrouvé

Le temps Unix, aussi appelé temps epoch ou temps POSIX, est un compte signé de secondes complètes écoulées depuis 1970-01-01T00:00:00Z, en ignorant les secondes intercalaires. Les systèmes d’exploitation, les claims JWT, les colonnes de base et les backends d’observabilité stockent les instants ainsi, parce qu’un entier n’emporte ni ambiguïté de nom de mois, ni séparateur local, ni branche d’heure d’été. Les humains ont encore besoin d’un visage calendaire : quelle année, quel mois et quel jour, et quelle heure, minute et seconde sur l’horloge UTC.

Retrouver ce visage est de l’arithmétique pure. Divisez l’entier par 86400 avec une division vers le bas pour obtenir un indice de jour relatif au 1er janvier 1970 et un reste non négatif qui est la seconde de ce jour UTC. Projetez l’indice par l’algorithme grégorien proleptique civil-from-days, avec les mêmes constantes d’ère et de jour d’ère publiées pour les bibliothèques de temps civil, jusqu’à l’année, le mois et le jour.

Découpez le reste par 3600 et 60 pour l’heure, la minute et la seconde. Formatez les six champs civils en chaîne date-heure UTC YYYY-MM-DDTHH:mm:ssZ. Zéro est minuit de l’epoch.

Moins un est 1969-12-31T23:59:59Z. Un milliard est la célèbre milliardième seconde Unix du 9 septembre 2001 à 01:46:40 UTC. Cette page répond à la recherche temps Unix : étant donné un compte entier de secondes, quelle est la date et l’heure de calendrier en UTC, sans décalage local et sans conjecture de fraction de seconde.

Le mappage ne consulte jamais une horloge murale, donc le même entier produit toujours la même chaîne en tests et en production.

Contrat d’entrée, règle entier-uniquement et forme de la réponse

La règle entier-uniquement est le contrat du produit : le temps Unix POSIX est un compte de secondes, pas de millisecondes ni une horloge flottante. Si un fournisseur a envoyé des millisecondes, divisez par mille chez l’appelant et envoyez le résultat en secondes complètes.

En succès le corps répète timestamp comme l’entier coercé ; year, month, day, hour, minute et second comme composantes civiles UTC ; datetime comme la chaîne date-heure UTC avec le désignateur Z ; timezone comme la constante UTC ; formula comme l’identité fixe ; et message comme un résumé d’une ligne. Une validation en échec n’est jamais facturée. Préférez affirmer la chaîne datetime et les composantes répétées dans des tests automatisés plutôt que de redériver le calendrier à la main dans chaque client.

Les années civiles après conversion doivent tomber entre 0001 et 9999 ; les valeurs hors de cette fenêtre sont rejetées au lieu d’être formatées avec débordement.

Où un convertisseur de temps Unix gagne sa place, et ce qu’il n’est pas

Les intervenants d’incident collent un compte brut de secondes issu d’une trace ou d’une ligne de journal et ont besoin d’un instant de calendrier UTC pour la frise du post-mortem, sans se fier au fuseau du portable. Les pipelines de données normalisent des colonnes epoch entières en chaînes date-heure UTC avant les chargements d’entrepôt et les exports d’audit. Les équipes d’ingénierie figent datetime pour des entrées connues afin que le formatage du client et du serveur ne diverge pas entre runtimes.

Tenez les millisecondes hors de ce contrat : divisez-les d’abord, ou vous atterrirez dans les années 50000. La sortie est toujours UTC avec le suffixe Z—il n’y a ni base de fuseaux nommés ni branche d’heure d’été—, donc les tableaux de bord qui ont besoin de l’heure d’une ville appliquent leur propre décalage après cette conversion. Préférez cette capacité lorsque vous avez déjà un compte en secondes complètes et n’avez besoin que de la chaîne de calendrier UTC.