Tempo tra date

Il tempo tra due riferimenti è l'intervallo di orologio che intercorre tra due date o ore esplicite, reso come giorni interi, ore residue e minuti residui. Chi cerca il tempo tra due date ha bisogno di quel dettaglio misto per un turno, un volo, un ricovero o una finestra di progetto, non di un'età civile in anni-mesi-giorni né di un conto alla rovescia in diretta con secondi avanzati. Questo strumento non inventa mai l'istante presente dall'orologio dell'host.

Che cosa conta davvero il tempo trascorso tra due riferimenti

Il tempo trascorso tra due riferimenti è una durata di orologio, non un'età civile né un conto alla rovescia in diretta. Il motore prende due istanti convalidati, sottrae i rispettivi conteggi assoluti di secondi, prende il valore assoluto così qualsiasi ordine è lecito, poi tronca l'intervallo in giorni interi di ottantaseimilaquattrocento secondi, ore residue di tremilaseicento secondi e minuti residui di sessanta secondi.

Un resto di cinquantanove secondi non diventa un minuto: i minuti sono minuti interi dopo aver rimosso giorni e ore, quindi il triplo è sempre costituito da interi non negativi, con ore da zero a ventitré e minuti da zero a cinquantanove. I valori solo data sono mezzanotte di quel giorno civile, così dal primo gennaio al terzo gennaio ci sono due giorni, zero ore e zero minuti.

Un datetime come il primo gennaio alle nove fino al secondo gennaio alle dieci e trenta è un giorno, un'ora e trenta minuti. I valori solo orologio, come le nove e quindici e le diciassette e quarantacinque, restano su un medesimo giorno anonimo e restituiscono zero giorni più le ore e i minuti di quella giornata. Istanti uguali restituiscono zero in ogni componente e segnano direction come zero.

Se la fine arriva prima dell'inizio, giorni, ore e minuti restano la lunghezza trascorsa assoluta e direction è backward, così una coppia invertita non fallisce e non inventa una durata negativa. La stringa formatted unisce i tre componenti in una riga leggibile, ad esempio due giorni, due ore, trenta minuti, per etichette e ricevute.

Usi un vicino anni-mesi-giorni quando la ricerca è da data a data come mesi civili, un vicino di minuti con segno quando il prodotto memorizza un solo intero, e un vicino di conto alla rovescia quando devono comparire i secondi residui; usi questa pagina quando la richiesta è il tempo tra due riferimenti e la risposta deve essere giorni, ore e minuti.

Contratto di ingresso, convalida delle date e forma della risposta

Ciascun valore può essere un giorno civile in forma YYYY-MM-DD, un datetime ISO-8601 completo con separatore T o spazio facoltativo, secondi facoltativi, frazione di secondo che viene troncata e una Z finale o uno scostamento numerico facoltativi, oppure un'ora solo orologio come HH:mm o HH:mm:ss. Gli anni vanno da uno a novemilanovecentonovantanove, i mesi da uno a dodici, e il giorno deve esistere in quel mese secondo le regole bisestili gregoriane, compreso il ventinove febbraio solo negli anni bisestili.

Le ore vanno da zero a ventitré e i minuti e i secondi da zero a cinquantanove. Un'ora solo orologio non può mescolarsi con una data o un datetime di calendario: entrambi gli estremi devono essere solo orologio oppure entrambi devono portare una data, altrimenti la richiesta fallisce nominando la coppia incoerente.

Entrambi gli estremi sono obbligatori di proposito: un calcolatore di tempo tra riferimenti che sostituisce in silenzio l'orologio dell'host produce risposte diverse nell'integrazione continua, su un portatile che attraversa un meridiano e su un worker in Coordinated Universal Time, il che rompe audit ed esportazioni riproducibili.

Dove un calcolatore di tempo tra due riferimenti merita il posto

Gli sportelli turni e le bozze di busta paga hanno bisogno di giorni, ore e minuti residui tra un timbro di ingresso e uno di uscita, non di un solo intero di minuti né di un'età civile in anni e mesi. Gli sportelli viaggio stampano lo stesso triplo su un itinerario così una partenza il venerdì mattina e un arrivo la domenica pomeriggio si descrivono come due giorni, alcune ore e minuti residui, invece di una media mobile che deriva attraversando un fuso.

Le cartelle di ospedale e albergo conservano l'intervallo misto contro due timbri espliciti così un revisore può ripetere la stessa coppia mesi dopo e ottenere lo stesso dettaglio. I cruscotti personali usano il calcolatore gratuito di tempo tra riferimenti nel browser per quanto è durato davvero un concerto, una lezione o un viaggio in auto, senza installare una libreria di date né spedire un database di fusi a ogni cliente.

Mantenga aspettative oneste: questa capacità misura il tempo di orologio trascorso tra due date o ore esplicite; non salta i fine settimana come durata lavorativa, non carica calendari di festività, non inventa l'oggi quando manca un campo, non converte mesi lunari e non conserva secondi residui nel triplo principale. La abbini a uno strumento anni-mesi-giorni quando il modulo chiede un'età civile, e a un ausilio di giorni interi quando il testo del prodotto non menziona mai le ore.

Poiché l'implementazione è parse pura di livello A, ogni chiamata riuscita resta economica, deterministica e priva di token di modello o rete in uscita, esattamente ciò di cui le suite di regressione hanno bisogno quando fissano coppie di giorno bisestile e di notte verso il mattino per decenni di timbri di inizio e di fine.