ForHosting KIT · Fechas y tiempo

Truncar fecha-hora a unidad

Lleve una fecha y hora al inicio de su año, mes, día, hora o minuto en UTC: 2024-06-15T14:37:52Z truncada al día queda en 2024-06-15T00:00:00Z. Útil para informes diarios, gráficos por hora y agrupar registros. Gratis en su navegador.

Gratis
Funciona en su navegador
Sin registro
Sus datos no salen de su equipo

Ejecutar — gratis Cómo funciona y API

Úselo desde WebAPIEmailTelegramApp pronto

Ejemplo resuelto

Si escribe

Fecha y hora: 2024-06-15T14:37:52Z day

Obtiene

Resultado: 2024-06-15T00:00:00Z day
Año: 2 024
Mes: 6
Día: 15

Truncar una marca de tiempo a una unidad más gruesa es la base de buckets diarios, informes mensuales, gráficos horarios y claves de caché que deben coincidir entre idiomas y hosts. Esta herramienta de truncar fecha-hora a unidad acepta una fecha-hora ISO-8601 explícita —hora completa con Z o un desfase numérico, o una cadena solo de fecha tratada como medianoche UTC— más una unidad de año, mes, día, hora o minuto. Normaliza la entrada a Tiempo Universal Coordinado con aritmética gregoriana pura y luego pone a cero todo campo menor que la unidad elegida, de modo que el resultado sea un instante de suelo UTC estable escrito como año-mes-día T hora-minuto-segundo Z. Los días de calendario imposibles y las unidades desconocidas fallan con un error de validación claro en lugar de inventar un desbordamiento.

Cómo funciona el truncado UTC sin reloj del sistema

Parta de una fecha-hora base explícita escrita en la forma internacional ISO para que todo cliente coincida en el mismo año, mes, día y campos de reloj opcionales. Cuando solo se suministra una fecha de calendario, trátela como medianoche en Tiempo Universal Coordinado. Cuando hay hora, acepte segundos fraccionarios opcionales truncados a segundos enteros y bien una Z final para UTC o un desfase numérico de horas y minutos con signo más o menos, que se resta al convertir a tiempo absoluto.

Valide que el día civil exista bajo las reglas de bisiesto gregorianas —el 29 de febrero es legal solo cuando el año es divisible por cuatro, salvo que los años de siglo también deban serlo por cuatrocientos— y que hora, minuto y segundo estén en sus rangos habituales.

Convierta el triple civil a un serial de día con el algoritmo days-from-civil de Howard Hinnant, multiplique por ochenta y cuatro mil seiscientos segundos, sume la hora local del día y reste los minutos de desfase por sesenta para obtener segundos de época UTC. Reconstruya año, mes, día, hora, minuto y segundo UTC con civil-from-days.

Aplique entonces un suelo puro por unidad: year reinicia mes a uno y día a uno con el reloj en cero; month conserva año y mes pero fija el día a uno y el reloj a cero; day conserva la fecha de calendario y pone el reloj a cero; hour pone a cero minuto y segundo; minute pone a cero solo el segundo. Formatee los campos civiles truncados como una cadena cuatro-dos-dos T dos-dos-dos Z.

Dónde las calculadoras de truncar fecha-hora a unidad aportan valor

Los pipelines de analítica materializan claves de eventos diarias y horarias bajando las marcas de ingestión al suelo, de modo que cada idioma y región comparta el mismo bucket UTC sin inventar una biblioteca de calendario. Los equipos de finanzas y operaciones agrupan líneas de libro o tickets de soporte en periodos de mes o día para resúmenes deterministas que coinciden con auditorías sin conexión.

Los paneles de producto y crecimiento grafican actividad por hora o día con un suelo estable para que las vistas previas del navegador y las agregaciones del backend no discrepen en una hora al cruzar el horario de verano.

Si más adelante necesita sumar horas o días a una marca, contar días entre dos fechas, calcular el inicio y fin de un mes, o convertir unidades de tiempo puras entre horas y minutos, trátelos como intenciones de búsqueda y páginas distintas en lugar de sobrecargar esta página de truncar fecha-hora a unidad: resuelven consultas diferentes aunque parte de la aritmética se parezca por debajo.

Qué puede hacer con ella

Buckets de analítica diarios y horarios

Baje marcas ISO de eventos a día u hora en UTC para que cada lenguaje del pipeline materialice la misma clave de agregación en gráficos y rollups.

Periodos de informe mensuales y anuales

Trunque fechas-hora de libro o tickets a mes o año para construir inicios de periodo deterministas en exportaciones, auditorías y resúmenes financieros.

Preguntas frecuentes

¿Qué unidades están admitidas?

Exactamente cinco tokens sin distinción de mayúsculas: year, month, day, hour y minute.

¿El truncado usa mi zona horaria local?

No. El suelo se calcula siempre en UTC a partir de la cadena de entrada explícita. Los desfases de la cadena se convierten primero a UTC; el reloj del anfitrión no se lee nunca.

¿Qué ocurre con un día de calendario inválido?

La tarea no pasa a marzo ni inventa un día bisiesto.

¿Qué obtengo al truncar al mes o al año?

Al truncar al mes obtiene el primer día de ese mes a medianoche UTC. Al truncar al año obtiene el 1 de enero de ese año a medianoche UTC, con todas las partes menores a cero.

¿Qué pasa con una hora escrita con desfase horario?

Primero se pasa a UTC y después se trunca. Por eso, una hora con desfase positivo puede quedar en otra hora o incluso en otro día distinto del que se ve en el texto original.

Herramientas relacionadas

Para desarrolladores — acceso por API

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

Endpoint de API

POSThttps://api.kit.forhosting.com/date/truncate-to-unit

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

Llámela desde su stack

curl -X POST https://api.kit.forhosting.com/date/truncate-to-unit \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2024-06-15T14:37:52Z","unit":"day"}'

const res = await fetch("https://api.kit.forhosting.com/date/truncate-to-unit", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "datetime": "2024-06-15T14:37:52Z",
    "unit": "day"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/truncate-to-unit",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "datetime": "2024-06-15T14:37:52Z",
    "unit": "day"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/truncate-to-unit", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"datetime":"2024-06-15T14:37:52Z","unit":"day"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"datetime":"2024-06-15T14:37:52Z","unit":"day"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/truncate-to-unit", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Ejemplo de solicitud

{
  "datetime": "2024-06-15T14:37:52Z",
  "unit": "day"
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.truncate_to_unit",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Precio

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

Errores

HTTP	Código	Significado
`401`	`unauthorized`	API key ausente o inválida.
`402`	`insufficient_balance`	El saldo no cubre el precio de la tarea.
`404`	`unknown_type`	El tipo de tarea no existe.
`429`	`rate_limited`	Demasiadas peticiones. Use el webhook en vez de sondear.

Notas técnicas

Las zonas horarias del anfitrión y las tablas de horario de verano hacen que un suelo ingenuo diverja entre navegadores, servidores y Workers en el borde.

Qué envía usted y qué recibe a cambio

Comprobaciones clásicas: bajar las catorce treinta y siete al día a medianoche UTC, bajar una marca matutina con desfase más-dos a la hora en Z puro, bajar al mes el primer día, bajar al año el primero de enero, y rechazar una base como el 29 de febrero en un año común. Envíe dos campos obligatorios: datetime como cadena ISO-8601, por ejemplo dos mil veinticuatro guion cero seis guion quince T catorce dos puntos treinta y siete dos puntos cincuenta y dos Z, y unit como uno de year, month, day, hour o minute (sin distinción de mayúsculas). Se aceptan los alias date, dt, timestamp y ts para la cadena base; los alias to, truncate_to y granularity para la unidad. Campos ausentes, datetime que no sea cadena, cadenas que no encajen en la forma ISO, días de calendario imposibles, componentes de hora inválidos y unidades fuera de los cinco tokens permitidos fallan con invalid_input y no se cobran. Si tiene éxito, la respuesta repite el datetime base recortado, la unit en minúsculas normalizada, la cadena ISO UTC resultante tras el truncado, el año, mes, día, hora, minuto y segundo numéricos del instante de suelo, el epoch_seconds del resultado y una fórmula breve que documenta la regla de suelo UTC. El precio de las llamadas API correctas es la base publicada de $0.002 por elemento; los fallos de validación no consumen saldo prepago.

Dónde las calculadoras de truncar fecha-hora a unidad aportan valor

Como la capacidad es un motor parse puro, el precio de la API es la base publicada de $0.002 por elemento correcto y la validación fallida no consume saldo.

Casos de integración

Fixtures de QA en límites de bucket

Genere instantes de suelo esperados en medianoche, inicios de mes y conversión de desfase a UTC para pruebas de regresión sin reloj del anfitrión.

Preguntas técnicas

¿Cómo truncar una fecha-hora al día en UTC?

Envíe datetime como cadena ISO-8601 y unit como day. La API devuelve la misma fecha de calendario a las 00:00:00Z tras normalizar cualquier desfase numérico a UTC.

¿Cuánto cuesta la herramienta de truncar fecha-hora a unidad?

La herramienta del navegador es gratuita. Las peticiones API usan saldo prepago KIT a $0.002 por llamada correcta; la entrada inválida no se factura.

Ver la documentación completa del KIT →

Ejecutar — gratis

Ejemplo resuelto

Cómo funciona el truncado UTC sin reloj del sistema

Dónde las calculadoras de truncar fecha-hora a unidad aportan valor

Qué puede hacer con ella

Buckets de analítica diarios y horarios

Periodos de informe mensuales y anuales

Preguntas frecuentes

Herramientas relacionadas

Para desarrolladores — acceso por API

Endpoint de API

Llámela desde su stack

Ejemplo de solicitud

Ejemplo de respuesta

Precio

Errores

Notas técnicas

Qué envía usted y qué recibe a cambio

Dónde las calculadoras de truncar fecha-hora a unidad aportan valor

Casos de integración

Fixtures de QA en límites de bucket

Preguntas técnicas

gracias