Tempo trascorso

Quanto tempo è passato tra due timestamp? Un calcolatore di tempo trascorso risponde a quella domanda quotidiana con una durata completa, non solo con giorni di calendario interi né solo con le ore di un quadrante. Lei indica un timestamp di inizio e uno di fine — istanti ISO-8601 come 2024-03-10T09:30:00Z, giorni solo data trattati come mezzanotte UTC, oppure secondi Unix — e lo strumento restituisce i giorni, le ore, i minuti, i secondi e i millisecondi trascorsi. Se la fine precede l'inizio, la richiesta viene rifiutata invece di restituire una durata negativa che un foglio presenze o un registro leggerebbero male in silenzio. Non c'è chiamata di rete, né orologio di sistema, né casualità: solo conversione del calendario civile in millisecondi UTC e una sottrazione che rifiuta di tornare indietro.

Come due timestamp diventano giorni, ore, minuti e secondi

Un timestamp nomina un istante sulla linea civile, non una posizione su un quadrante di dodici o ventiquattro ore né una durata che Lei abbia già misurato. 2024-03-10T09:30:00Z è un unico istante UTC; 2024-03-12T14:45:30Z è un istante successivo. La regola del tempo trascorso converte ciascun istante in millisecondi dall'epoca Unix con aritmetica gregoriana prolettica — anni bisestili, lunghezze dei mesi e scostamenti di fuso compresi — e poi sottrae l'inizio dalla fine.

Il resto non negativo si spezza con divisioni intere successive: ottantasei milioni e quattrocentomila millisecondi formano un giorno, tre milioni e seicentomila un'ora, sessantamila un minuto e mille un secondo. Ciò che resta è il residuo di millisecondi. Timestamp uguali danno tempo trascorso zero, non un giorno intero, perché le due letture nominano lo stesso istante.

I valori solo data come 2024-01-01 sono trattati come mezzanotte UTC, così una settimana dal primo all'ottavo è esattamente sette giorni. I secondi Unix numerici si moltiplicano per mille; i valori la cui magnitudine assoluta è almeno un bilione sono già trattati come millisecondi, che è il modo in cui gli esportatori di registro e i browser di solito marcano gli eventi.

Contratto di ingresso, formati accettati e l'errore di fine anteriore all'inizio

Il corpo della richiesta porta due campi obbligatori: start e end. Ciascuno può essere una data ISO-8601 in forma YYYY-MM-DD, una data-ora ISO-8601 con secondo frazionario facoltativo e uno scostamento Z oppure più-o-meno HH:mm, oppure un timestamp Unix come numero o stringa numerica. Gli spazi iniziali e finali vengono ritagliati.

Quando l'istante end analizzato è anteriore all'istante start analizzato, l'attività fallisce anch'essa, con un messaggio che la fine precede l'inizio: questo calcolatore non inventerà un passaggio a mezzanotte né una durata negativa con segno. L'ingresso non valido non viene fatturato.

Dove un calcolatore di tempo trascorso merita il posto

Si ricorre a un calcolatore di tempo trascorso quando due istanti registrati devono diventare una lunghezza che una persona legge e uno script conserva. Chi dirige un incidente converte un timestamp di inizio e uno di fine in giorni e ore per una finestra di SLA. I team di prodotto e supporto misurano quanto è durata una sessione, un lavoro o una distribuzione, dalla prima riga di registro all'ultima.

Gli strumenti di paga e di presenze che già conservano ingresso e uscita come date-ora hanno bisogno di una durata, non di un conteggio di giorni di calendario né di un passaggio di quadrante nello stesso giorno. Gli studenti che imparano il tempo trascorso verificano che 09:30 del dieci a 14:45:30 del dodici siano due giorni, cinque ore, quindici minuti e trenta secondi, e non un errore di prestito sulla carta.

Abbini questa pagina a uno strumento di durata tra orari di quadrante se ha solo due ore del giorno e nessuna data, a un conteggio di giorni civili se vuole solo giornate di calendario intere, o a un formattatore di durata leggibile se ha già un numero di secondi e le serve solo il testo. Poiché lo strumento rifiuta un intervallo invertito, serve anche da validatore dell'ordine dei timestamp per i moduli di raccolta che non devono accettare una fine prima di un inizio.