Arredonde data e hora para baixo por intervalo UTC

O cálculo converte primeiro o valor Z ou o deslocamento numérico informado para UTC e depois desce ao múltiplo do intervalo solicitado, medido desde a época Unix. Ele usa somente a data e hora, o intervalo e a unidade que você fornecer. Assim, o resultado atende ao agrupamento estável de eventos, às chaves de cache, às janelas de relatórios e aos testes sem consultar relógio, localidade, serviço de rede ou fuso da máquina.

Escolha um instante e um intervalo explícitos

Forneça uma data e hora ISO-8601 completa com data do calendário, horas, minutos, segundos e Z ou um deslocamento UTC numérico. O deslocamento é obrigatório porque uma leitura isolada do relógio local não identifica um único instante. Por exemplo, 09:30 em Nova York e 09:30 em Londres são pontos diferentes da linha do tempo. Depois, informe um intervalo inteiro positivo e escolha minuto ou segundo como unidade. Um intervalo de 15 minutos cria blocos em limites UTC previsíveis, enquanto um de 20 segundos é útil para fluxos de eventos mais densos. Os valores em minutos vão de 1 a 1440 e os valores em segundos, de 1 a 86400, mantendo cada solicitação limitada a no máximo um dia. Frações de segundo são aceitas na data e hora explícita, mas o arredondamento opera com precisão de segundos inteiros e remove a fração. A resposta repete as configurações, mostra o instante UTC normalizado e retorna a data arredondada e o timestamp Unix inteiro para que você use a representação mais conveniente.

Entenda a regra de arredondamento inferior em UTC

A operação converte a data e hora fornecida em uma contagem inteira de segundos relativa a 1970-01-01T00:00:00Z. Ela transforma o intervalo escolhido em segundos, aplica a divisão de piso matemática e multiplica novamente pelo tamanho do intervalo. Trata-se de um arredondamento real para baixo, e não para o limite mais próximo: 14:37:52Z em 15 minutos se torna 14:30:00Z, nunca 14:45:00Z. Os limites ficam ancorados na época Unix, eliminando ambiguidades para intervalos que não dividem uma hora igualmente. Um intervalo de sete minutos, por exemplo, acompanha múltiplos consecutivos de sete minutos na linha do tempo UTC global em vez de reiniciar segundo uma convenção local não declarada. O piso matemático também importa antes de 1970, pois segue para o limite anterior em vez de truncar em direção a zero. Os deslocamentos numéricos são resolvidos antes da seleção do bloco; portanto, representações equivalentes do mesmo instante geram o mesmo resultado. A implementação valida diretamente datas gregorianas e campos do relógio, além de fazer a conversão civil com aritmética inteira, sem chamar Date nem herdar o fuso do sistema.

Use blocos estáveis em sistemas automatizados

Uma data e hora arredondada funciona como uma chave de bloco compacta e explicável. Pipelines analíticos podem agrupar registros recebidos em janelas idênticas antes da agregação. Caches podem derivar grupos de expiração sem permitir que milissegundos ou configurações de fuso do cliente fragmentem chaves equivalentes. Sistemas de monitoramento podem normalizar observações em uma cadência fixa, e testes podem confirmar limites exatos sem congelar o relógio do sistema. Armazene floored_datetime quando pessoas ou logs precisarem de um valor UTC legível, ou use floored_epoch_seconds para comparações numéricas e índices de banco de dados. Como o resultado depende apenas dos três campos de entrada, repetir uma solicitação produz o mesmo objeto, e processar registros fora de ordem não altera respostas anteriores. O preço da API é US$ 0,002 por item, enquanto o executor do navegador realiza localmente o mesmo cálculo puro. Esta capacidade não deduz fuso horário, não lê a hora atual, não cria blocos mensais de calendário e não arredonda para cima. Se o limite do seu negócio depender de um fuso nomeado com horário de verão, resolva essa regra antes e envie o deslocamento ISO explícito resultante.