Capire i timestamp Unix
I timestamp Unix sembrano semplici perché sono solo numeri, ma compaiono praticamente ovunque nel lavoro web. API, log, esportazioni, messaggi in coda e registrazioni di eventi si basano su di essi. Il formato è un singolo intero che conta i secondi (o millisecondi) dal 1° gennaio 1970 UTC.
Il vantaggio è la coerenza. Un timestamp è compatto, neutro rispetto al fuso a livello di archiviazione e facile da confrontare, ordinare o trasmettere via software. La sfida è che non è leggibile da solo: un valore come 1710153600 non dice nulla finché non viene convertito in una data.
Ecco perché gli strumenti per i timestamp restano utili anche per sviluppatori esperti. Spesso bisogna rispondere a domande pratiche al volo: questo valore è in secondi o millisecondi? Che data rappresenta in UTC e nell'ora locale? Quale timestamp corrisponde a una data specifica per una richiesta di test?
Quando è utile
- Esaminare risposte API che restituiscono campi temporali numerici come
created_atoexpires_at. - Controllare log in cui gli orari degli eventi sono salvati come valori Unix grezzi.
- Fare debug di problemi di fuso orario tra un servizio backend e il browser.
- Convertire una data leggibile in tempo Unix prima di testare una richiesta o un payload.
Esempio pratico
Immagina che un'API mandi 1710153600 in un payload JSON. A colpo d'occhio il numero non dice molto, ma convertendolo si vede che corrisponde a una specifica data UTC e a una data locale nel tuo fuso. Subito si capisce se il valore è plausibile o sballato di ore, giorni o addirittura di un fattore mille di scala.
Anche qui contano i millisecondi. Un valore come 1710153600000 rappresenta lo stesso istante ma in millisecondi anziché secondi. Se li scambi, la data sarà completamente sbagliata.
Casi d'uso comuni
- Verificare se un campo timestamp in un payload usa secondi o millisecondi.
- Confrontare l'orario di un evento in UTC con ciò che gli utenti vedono in ora locale.
- Creare valori di scadenza di esempio per test e demo.
- Verificare che il codice di backend e quello di frontend convertano allo stesso modo.
- Leggere vecchi dati esportati senza aprire una console o uno script separato.
Usa il convertitore nel browser
Usa lo strumento nel browser per farlo in pochi secondi.
FAQ
Perché i timestamp usano UTC?
UTC fornisce al software un punto di riferimento stabile. La versione locale leggibile può cambiare con il fuso, il timestamp salvato no.
Perché alcuni timestamp hanno 10 cifre e altri 13?
Dieci cifre di solito indicano secondi. Tredici cifre di solito indicano millisecondi.
Servono sempre sia UTC sia l'ora locale?
Di solito sì, quando stai facendo debug. UTC aiuta a confrontare i sistemi, l'ora locale aiuta a verificare ciò che ha effettivamente visto una persona.