Frazione dell’anno trascorsa

Converte in UTC l’orario indicato con Z o con uno scostamento numerico, misura i millisecondi esatti dal 1º gennaio alle 00:00:00 UTC e divide tale durata per la lunghezza complessiva dell’anno UTC risultante. Gli anni bisestili hanno 366 giorni, quelli comuni 365. La data corrente, il fuso locale, la rete, valori casuali e impostazioni nascoste non possono alterare il risultato.

Che cosa indica la frazione dell’anno trascorsa

La frazione restituita misura in modo continuo l’avanzamento all’interno di un anno civile UTC. Il numeratore è il numero di millisecondi dal 1º gennaio alle 00:00:00.000 UTC fino all’istante fornito; il denominatore è il numero di millisecondi dell’intero anno UTC. Al primo istante del 1º gennaio il risultato è esattamente zero. Aumenta poi nel corso dell’anno, ma resta inferiore a uno per ogni data e ora valida di quell’anno; il valore uno coincide con il primo istante dell’anno successivo, che appartiene già al nuovo anno e fa ripartire il calcolo da zero. È una definizione diversa da una percentuale basata sul giorno dell’anno che conti date intere o consideri conclusa la giornata corrente. Mezzogiorno contribuisce per metà della data, i secondi incidono nella loro misura esatta e fino a tre cifre decimali di secondo vengono conservate come millisecondi. Il denominatore comprende 365 giorni in un anno comune e 366 in un anno bisestile gregoriano. Poiché lo scostamento viene normalizzato prima di selezionare l’anno UTC, un istante scritto alla fine del 31 dicembre in un altro fuso può appartenere correttamente al 1º gennaio dell’anno UTC seguente.

Come fornire una data e ora ISO non ambigua

Invii datetime nel formato YYYY-MM-DDTHH:mm:ssZ. Può aggiungere da una a tre cifre decimali di secondo oppure sostituire Z con uno scostamento dotato di segno, come +05:30 o -04:00. L’indicazione del fuso è obbligatoria perché una data e ora priva di tale informazione non identifica un unico istante. Le sole date, i formati locali, i nomi dei mesi, gli spazi al posto di T e gli scostamenti senza due punti vengono rifiutati, senza tentativi di interpretazione. Il parser convalida anche la durata dei mesi gregoriani, i giorni bisestili, le ore, i minuti, i secondi e i campi dello scostamento. I secondi intercalari non sono accettati: i secondi vanno da 00 a 59, in conformità con il modello deterministico di minuto civile. Dopo l’analisi, lo scostamento viene applicato con aritmetica intera e l’istante risultante è riportato come utc_datetime. La risposta espone inoltre utc_year, elapsed_milliseconds e year_milliseconds, così Lei può verificare la frazione senza ricostruire le regole del calendario. Due stringhe che descrivono lo stesso istante con scostamenti diversi producono la stessa data normalizzata e la stessa frazione. Una richiesta automatizzata riuscita costa $0.002; il calcolo può anche essere eseguito localmente nel browser.

Quando è utile un rapporto annuale deterministico

Utilizzi questa capacità quando un modello, una visualizzazione, un report o un test richiede una posizione stabile nell’anno civile, anziché una risposta legata al momento in cui una macchina esegue il calcolo. I cruscotti possono convertire la frazione in percentuale o in barra di avanzamento, mantenendo numeratore e denominatore esatti per etichette e verifiche. Le pipeline di dati possono arricchire record con marca temporale mediante una coordinata annuale normalizzata per analisi stagionali, interpolazioni o variabili cicliche, sapendo che gli input con scostamento vengono confrontati sulla stessa linea temporale UTC. I test possono fissare casi limite a Capodanno, nel giorno bisestile o all’ultimo millisecondo di dicembre senza simulare un orologio. Il risultato si basa sulla durata trascorsa, quindi non va usato per contare date completate, giorni lavorativi, periodi fiscali o mesi di uguale lunghezza. Modella inoltre intenzionalmente i giorni civili UTC come 86.400 secondi e non inserisce secondi intercalari, rendendo l’operazione portabile e riproducibile. Se Le occorre una percentuale, moltiplichi fraction per cento e arrotondi solo in fase di visualizzazione. Per una quota dell’esercizio fiscale, impieghi i confini del relativo calendario.