Cos'è un timestamp Unix? Una guida chiara per gli sviluppatori

Apri un file di log, una risposta di un’API o una riga di database e trovi un campo come 1755432000 dove ti aspettavi una data. Quel numero è un timestamp Unix, uno dei modi più comuni con cui i computer memorizzano un istante nel tempo. Una volta che capisci ciò che rappresenta, smette di essere criptico e diventa uno dei formati di data più semplici che esistano. Questa guida spiega il tempo Unix e mostra come convertirlo in entrambe le direzioni con il Convertitore di timestamp Unix.

Cos’è davvero un timestamp Unix

Un timestamp Unix è il numero di secondi trascorsi a partire da un unico momento di riferimento fisso: la mezzanotte del 1 gennaio 1970, in UTC. Quel punto di riferimento si chiama epoca Unix. Quindi 0 è l’epoca stessa, 60 è un minuto dopo di essa e 1755432000 è il numero di secondi trascorsi da allora.

Poiché viene contato in UTC, un timestamp Unix non porta con sé alcun fardello di fuso orario. Lo stesso numero indica lo stesso istante ovunque sulla Terra. Un server a Tokyo e un server a New York che registrano lo stesso evento memorizzeranno un timestamp identico, anche se l’ora locale dell’orologio è diversa. Il fuso orario conta solo quando riconverti quel numero in una data leggibile da un essere umano per visualizzarla.

Perché i sistemi memorizzano il tempo in questo modo

Memorizzare il tempo come un semplice numero intero risolve una serie di problemi che le date in formato testo creano:

• Il confronto è banale. Per scoprire quale di due eventi è avvenuto per primo, confronti due numeri. Nessuna analisi, nessuna logica di calendario.
• I calcoli sono facili. Aggiungere un’ora significa aggiungere 3600. Trovare l’intervallo tra due eventi è una sola sottrazione.
• Non c’è ambiguità. Una stringa come 03/04/05 potrebbe essere tre date diverse a seconda della regione. Un timestamp ha esattamente un solo significato.
• È compatto e ordinabile. Ordinare le righe per un numero è veloce e ti restituisce gratuitamente il corretto ordine cronologico.

Ecco perché database, formati di log, metadati dei file, campi di scadenza dei JWT e innumerevoli API si appoggiano al tempo Unix dietro le quinte, per poi convertirlo in un formato comprensibile solo ai margini.

Secondi contro millisecondi, la trappola classica

Ecco il dettaglio che frega quasi tutti. Il tempo Unix classico conta i secondi, ma molti sistemi, JavaScript in particolare, contano i millisecondi a partire dalla stessa epoca. Un timestamp in millisecondi è semplicemente il valore in secondi moltiplicato per 1000, quindi ha tre cifre in più.

Il rapido controllo di buon senso: un timestamp attuale in secondi ha circa 10 cifre, mentre un timestamp attuale in millisecondi ne ha circa 13. Se la tua data convertita finisce nel 1970, quasi certamente hai fornito millisecondi a uno strumento che si aspettava secondi, o viceversa. Sapere quale unità hai in mano evita date sbagliate di un fattore mille.

Come convertire un timestamp in una data e viceversa

Non devi fare questa aritmetica a mano. Il gratuito Convertitore di timestamp Unix viene eseguito interamente nel tuo browser, quindi i valori che incolli non vengono mai caricati.

1. Per trasformare un timestamp in una data leggibile, incolla il numero e leggi la data e l’ora umane che rappresenta.
2. Per andare nella direzione opposta, inserisci una data e un’ora di calendario e ottieni il timestamp Unix corrispondente.
3. Tieni d’occhio l’unità. Se la tua fonte è in millisecondi, considera le tre cifre extra affinché il tuo risultato non finisca sfasato di decenni.

Poiché funziona offline nella scheda, puoi convertire in tutta sicurezza i timestamp di log interni o di documenti privati senza inviarli a un server.

Fare di più che convertire

Convertire un singolo timestamp è spesso solo il primo passo. Una volta che hai due date reali, di solito vuoi sapere l’intervallo tra di esse. Il Calcolatore di differenza tra date ti dice quanti giorni separano due date, mentre il Calcolatore di durata gestisce gli intervalli misurati in ore e minuti, il che è utile quando stai ragionando su quanto a lungo un processo è stato in esecuzione tra due timestamp di log.

Per il caso specifico e comune in cui si tratta di calcolare l’età di qualcosa o qualcuno a partire da una data di inizio, il Calcolatore di età ti restituisce direttamente anni, mesi e giorni, così non devi convertire un timestamp di nascita e contare a mano.

La versione breve

Un timestamp Unix è semplicemente il conteggio dei secondi trascorsi dal 1 gennaio 1970 UTC, il che rende semplice e univoco memorizzare, confrontare e fare calcoli sul tempo. Tieni d’occhio la distinzione tra secondi e millisecondi, ricorda che il numero grezzo non porta con sé alcun fuso orario e converti ai margini quando un essere umano deve leggerlo. Il Convertitore di timestamp Unix gestisce entrambe le direzioni istantaneamente e in modo riservato nel tuo browser, così quel numero misterioso nei tuoi log diventa una data reale in un secondo.