Arrotondare data e ora all’intervallo UTC inferiore

Il calcolo converte prima in UTC il valore Z o lo scostamento numerico fornito, quindi scende al multiplo dell’intervallo richiesto misurato dall’epoca Unix. Usa esclusivamente la data e ora, l’intervallo e l’unità indicati da Lei. Il risultato è quindi adatto a raggruppamenti stabili di eventi, chiavi di cache, finestre di report e dati di prova, senza consultare orologi, impostazioni locali, servizi di rete o il fuso del computer.

Scelga un istante e un intervallo espliciti

Fornisca una data e ora ISO-8601 completa di data civile, ore, minuti, secondi e Z oppure di uno scostamento UTC numerico. Lo scostamento è indispensabile perché una lettura dell’ora locale, da sola, non identifica un unico istante. Per esempio, le 09:30 a New York e le 09:30 a Londra sono punti diversi della linea temporale. Indichi quindi un intervallo intero positivo e scelga minuto o secondo come unità. Un intervallo di 15 minuti crea blocchi su confini UTC prevedibili, mentre uno di 20 secondi è utile per flussi di eventi più densi. I valori in minuti possono variare da 1 a 1440 e quelli in secondi da 1 a 86400, limitando ogni richiesta a un massimo di un giorno. Le frazioni di secondo sono accettate nella data e ora esplicita, ma l’arrotondamento opera alla precisione del secondo intero e rimuove necessariamente la frazione. La risposta ripete le impostazioni, mostra l’istante UTC normalizzato e restituisce sia la data arrotondata sia il relativo timestamp Unix intero, affinché Lei possa usare la rappresentazione più comoda.

Comprenda la regola di arrotondamento inferiore UTC

L’operazione converte la data e ora fornita in un conteggio intero di secondi rispetto a 1970-01-01T00:00:00Z. Converte l’intervallo scelto in secondi, applica la divisione matematica con funzione pavimento e moltiplica di nuovo per la dimensione dell’intervallo. È un vero arrotondamento per difetto, non al confine più vicino: 14:37:52Z con un intervallo di 15 minuti diventa 14:30:00Z, mai 14:45:00Z. I confini sono ancorati all’epoca Unix, eliminando le ambiguità per intervalli che non dividono uniformemente un’ora. Un intervallo di sette minuti, per esempio, segue multipli consecutivi di sette minuti sulla linea temporale UTC globale, anziché ripartire secondo una convenzione locale non dichiarata. Il pavimento matematico è importante anche prima del 1970, perché procede verso il confine precedente invece di troncare verso zero. Gli scostamenti numerici vengono risolti prima di scegliere il blocco; rappresentazioni equivalenti dello stesso istante producono quindi lo stesso risultato. L’implementazione convalida direttamente date gregoriane e campi orari ed esegue la conversione civile con aritmetica intera, senza richiamare Date né ereditare il fuso del sistema.

Usi blocchi stabili nei sistemi automatizzati

Una data e ora arrotondata è una chiave di blocco compatta e comprensibile. Le pipeline analitiche possono raggruppare i record in ingresso in finestre identiche prima dell’aggregazione. Le cache possono ricavare gruppi di scadenza senza lasciare che millisecondi o impostazioni del fuso del client frammentino chiavi altrimenti equivalenti. I sistemi di monitoraggio possono normalizzare le osservazioni a una cadenza fissa e i test verificare confini esatti senza bloccare l’orologio di sistema. Conservi floored_datetime quando persone o registri necessitano di un valore UTC leggibile, oppure usi floored_epoch_seconds per confronti numerici e indici di database. Poiché il risultato dipende solo dai tre campi di input, ripetere una richiesta genera lo stesso oggetto ed elaborare record fuori ordine non modifica le risposte precedenti. Il prezzo dell’API è $0.002 per elemento, mentre l’esecutore nel browser svolge localmente lo stesso calcolo puro. Questa capacità non deduce un fuso, non legge l’ora corrente, non crea blocchi mensili di calendario e non arrotonda verso l’alto. Se il confine aziendale dipende da un fuso denominato con ora legale, risolva prima tale regola e trasmetta lo scostamento ISO esplicito ottenuto.