Redondear fecha y hora hacia abajo por intervalo UTC

El cálculo convierte primero a UTC el valor Z o el desplazamiento numérico proporcionado y después baja al múltiplo del intervalo solicitado, medido desde la época Unix. Solo utiliza la fecha y hora, el intervalo y la unidad que usted indique. Por ello, el resultado sirve para agrupar eventos, crear claves de caché, definir ventanas de informes y preparar pruebas estables sin consultar ningún reloj, configuración regional, servicio de red ni zona horaria del equipo.

Elija un instante y un intervalo explícitos

Proporcione una fecha y hora ISO-8601 completa con fecha de calendario, horas, minutos, segundos y Z o un desplazamiento UTC numérico. El desplazamiento es imprescindible porque una hora local aislada no identifica un instante único. Por ejemplo, las 09:30 de Nueva York y las 09:30 de Londres ocupan puntos distintos en la línea temporal. Después, indique un intervalo entero positivo y seleccione minuto o segundo como unidad. Un intervalo de 15 minutos genera bloques en límites UTC previsibles, mientras que uno de 20 segundos resulta práctico para flujos de eventos más densos. Los minutos pueden ir de 1 a 1440 y los segundos de 1 a 86400, por lo que cada solicitud queda limitada a un día como máximo. Se admiten fracciones de segundo en la fecha explícita, pero el redondeo funciona con precisión de segundos enteros y elimina la fracción. La respuesta repite la configuración, muestra el instante UTC normalizado y devuelve tanto la fecha redondeada como su marca Unix entera para que usted use la representación más conveniente.

Comprenda la regla de redondeo inferior en UTC

La operación convierte la fecha y hora recibida en un número entero de segundos respecto de 1970-01-01T00:00:00Z. Convierte también el intervalo elegido a segundos, aplica una división de piso matemática y vuelve a multiplicar por el tamaño del intervalo. Es un redondeo inferior real, no al límite más cercano: 14:37:52Z con 15 minutos se convierte en 14:30:00Z, nunca en 14:45:00Z. Los límites se anclan en la época Unix, lo que evita ambigüedades cuando el intervalo no divide una hora de manera exacta. Por ejemplo, un intervalo de siete minutos sigue múltiplos consecutivos de siete minutos en la línea temporal UTC global, sin reiniciarse según una convención local no declarada. El piso matemático también importa antes de 1970, pues avanza hacia el límite anterior en vez de truncar hacia cero. Los desplazamientos numéricos se resuelven antes de elegir el bloque; por eso, dos representaciones del mismo instante producen el mismo resultado. La implementación valida directamente el calendario gregoriano y el reloj, y convierte fechas mediante aritmética entera sin invocar Date ni heredar la zona horaria del sistema.

Utilice bloques estables en sistemas automatizados

Una fecha redondeada funciona como clave de bloque compacta y explicable. Las canalizaciones analíticas pueden agrupar registros entrantes en ventanas idénticas antes de agregarlos. Las cachés pueden obtener grupos de vencimiento sin que los milisegundos o la zona horaria del cliente fragmenten claves equivalentes. Los sistemas de supervisión pueden normalizar observaciones a una cadencia fija y las pruebas pueden comprobar límites exactos sin congelar el reloj del sistema. Guarde floored_datetime cuando una persona o un registro necesiten un valor UTC legible, o use floored_epoch_seconds para comparaciones numéricas e índices de base de datos. Como el resultado solo depende de los tres campos, repetir una solicitud produce el mismo objeto y procesar registros desordenados no cambia las respuestas anteriores. El precio de la API es $0.002 por elemento, mientras que el ejecutor del navegador realiza localmente el mismo cálculo puro. Esta capacidad no infiere zonas horarias, no lee la hora actual, no crea bloques mensuales de calendario ni redondea hacia arriba. Si su límite empresarial depende de una zona con horario de verano, resuelva antes esa regla y envíe el desplazamiento ISO explícito resultante.