Convertitore tempo Unix

Un convertitore di tempo Unix trasforma quell’intero in una data di calendario e un’ora di orologio che una persona può leggere: anno, mese, giorno, ora, minuto e secondo, sempre in UTC. Questo strumento accetta un timestamp intero finito in secondi, lo suddivide in un indice di giorno UTC e un’ora del giorno con divisione intera verso il basso, mappa l’indice sul calendario gregoriano prolettico con l’aritmetica civil-from-days pubblicata e restituisce una stringa data-ora UTC deterministica della forma YYYY-MM-DDTHH:mm:ssZ. Gli interi negativi sono di prima classe: codificano istanti precedenti all’epoch, come il 31 dicembre 1969.

Che cosa conta il tempo Unix e come si recupera il calendario UTC

Il tempo Unix, detto anche tempo epoch o tempo POSIX, è un conteggio con segno di secondi interi trascorsi da 1970-01-01T00:00:00Z, ignorando i secondi intercalari. I sistemi operativi, le claim JWT, le colonne di database e i backend di osservabilità memorizzano gli istanti così perché un intero non porta ambiguità di nome del mese, né separatore locale, né ramo dell’ora legale. Le persone hanno ancora bisogno di un volto di calendario: quale anno, mese e giorno, e quale ora, minuto e secondo sull’orologio UTC.

Recuperare quel volto è aritmetica pura. Si divida l’intero per 86400 con divisione verso il basso per ottenere un indice di giorno relativo al 1 gennaio 1970 e un resto non negativo che è il secondo di quel giorno UTC. Si mappi l’indice con l’algoritmo gregoriano prolettico civil-from-days, usando le stesse costanti di era e giorno d’era pubblicate per le librerie di tempo civile, fino ad anno, mese e giorno.

Si suddivida il resto per 3600 e 60 per ora, minuto e secondo. Si formattino i sei campi civili come stringa data-ora UTC YYYY-MM-DDTHH:mm:ssZ. Lo zero è la mezzanotte dell’epoch.

Il meno uno è 1969-12-31T23:59:59Z. Un miliardo è il celebre miliardesimo secondo Unix del 9 settembre 2001 alle 01:46:40 UTC. Questa pagina risponde alla ricerca tempo Unix: dato un conteggio intero di secondi, qual è la data e l’ora di calendario in UTC, senza scostamento locale e senza congetture di frazione di secondo.

Il mapping non consulta mai un orologio a muro, quindi lo stesso intero produce sempre la stessa stringa in test e in produzione.

Contratto di ingresso, regola solo-intero e forma della risposta

La regola solo-intero è il contratto del prodotto: il tempo Unix POSIX è un conteggio di secondi, non di millisecondi né un orologio in virgola mobile. Se un fornitore ha inviato millisecondi, li si divida per mille nel chiamante e si invii il risultato in secondi interi.

In caso di successo il corpo ripete timestamp come l’intero coercito; year, month, day, hour, minute e second come componenti civili UTC; datetime come la stringa data-ora UTC con designatore Z; timezone come la costante UTC; formula come l’identità fissa; e message come un riepilogo di una riga. La convalida fallita non viene mai addebitata. Si preferisca asserire la stringa datetime e i componenti ripetuti nei test automatici piuttosto che ricalcolare il calendario a mano in ogni client.

Gli anni civili dopo la conversione devono cadere tra 0001 e 9999; i valori fuori da quella finestra vengono rifiutati invece di essere formattati con overflow.

Dove un convertitore di tempo Unix vale la pena, e che cosa non è

Chi risponde a un incidente incolla un conteggio grezzo di secondi da uno stack trace o da una riga di log e ha bisogno di un istante di calendario UTC per la linea temporale del postmortem, senza fidarsi del fuso del portatile. Le pipeline di dati normalizzano colonne epoch intere in stringhe data-ora UTC prima dei carichi di magazzino e delle esportazioni di audit. I team di ingegneria fissano datetime per ingressi noti così che la formattazione del client e del server non diverga tra runtime.

Si tengano i millisecondi fuori da questo contratto: li si divida prima, o si finirà negli anni 50000. L’uscita è sempre UTC con suffisso Z—non c’è una base di fusi nominati né un ramo dell’ora legale—, quindi i cruscotti che necessitano dell’ora di una città applicano il proprio scostamento dopo questa conversione. Si preferisca questa capacità quando si ha già un conteggio in secondi interi e serve solo la stringa di calendario UTC.