Convertidor de fecha ordinal ISO
El 15 de marzo de 2024 es el día 75 del año, que en forma ordinal ISO se escribe 2024-075. Convierta cualquier fecha en su número de día del año y viceversa, con los años bisiestos ya tenidos en cuenta. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Fecha
- 2024-03-15
- Año
- 2 024
- Mes
- 3
- Día
- 15
- Día del año
- 75
La norma ISO 8601 define dos formas de fecha civil que comparten el mismo año pero expresan el día de manera distinta: la conocida terna calendario año-mes-día y la forma ordinal, año más día del año, que va de uno a 365 o 366. Los pipelines que almacenan números de día secuenciales, los conjuntos de datos científicos, los manifiestos logísticos y los registros de cumplimiento suelen necesitar un puente sin pérdidas entre ambas formas sin depender de los objetos Date del lenguaje anfitrión ni de las peculiaridades de las zonas horarias.
Forma calendario, forma ordinal y cuándo conviene cada dirección
Una fecha de calendario ISO se escribe con el año de cuatro dígitos, el mes de dos dígitos y el día de dos dígitos separados por guiones; por ejemplo, 2024-03-15 para el quince de marzo. Una fecha ordinal ISO usa el mismo año, un guion y un día del año de tres dígitos que va de 001 el primero de enero a 365 en un año común o 366 en un año bisiesto gregoriano.
Convierta de calendario a ordinal cuando necesite un índice de día compacto dentro de un año, nombres de archivo secuenciales o analíticas que traten cada día como un eje entero. Convierta de ordinal a calendario cuando una fuente solo entregue el día del año y su interfaz, factura o validador espere mes y día.
Años bisiestos, longitud del año y errores de día del año no válido
Según las reglas gregorianas, un año es bisiesto cuando es divisible entre cuatro, salvo que los años seculares deben ser además divisibles entre cuatrocientos. Los años bisiestos tienen 366 días y un febrero de 29 días; los años comunes tienen 365 días y un febrero de 28 días. Por eso el año 2000 es bisiesto, el 1900 no lo es, y 2024 es bisiesto mientras que 2023 no lo es.
Las entradas de calendario con un día imposible para el mes, como el 31 de abril o el 29 de febrero en un año no bisiesto, también se rechazan.
Qué puede hacer con ella
Logística y nomenclatura de archivos por lotes
Almacenes y trabajos por lotes nombran archivos con secuencias YYYY-DDD y necesitan un puente fiable hacia etiquetas YYYY-MM-DD legibles por personas en interfaces y facturas.
Validación de fuentes ordinales
Las integraciones que reciben el día del año de terceros rechazan valores desbordados, como el día 366 en un año no bisiesto, antes de que entren en sistemas de facturación o planificación.
Preguntas frecuentes
¿Qué ocurre si el día ordinal supera la longitud del año?
Por ejemplo, el día 366 en un año no bisiesto, o cualquier día superior a 366, se rechaza y no se cobra.
¿Es gratuito el convertidor de fecha ordinal ISO?
La herramienta del navegador funciona gratis en su dispositivo.
¿Cuál es la fecha ordinal del 15 de marzo de 2024?
Es 2024-075, porque el 15 de marzo es el día 75 de 2024. Primero va el año y después una cuenta de tres cifras que empieza en 001 el 1 de enero.
¿Por qué un año bisiesto cambia el número de día después de febrero?
El año bisiesto añade el 29 de febrero, así que cada fecha a partir del 1 de marzo recibe un número una unidad mayor que en un año común. Por eso la cuenta termina en 366 y no en 365.
¿Puedo pasar un número de día del año a una fecha normal?
Sí. Escriba el año y el número de día, por ejemplo 2024-075, y obtendrá el mes y el día, en este caso el 15 de marzo de 2024. Un número mayor que la duración de ese año se rechaza.
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
¿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/ordinal-date \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-03-15","calendar":"valor-ejemplo"}'const res = await fetch("https://api.kit.forhosting.com/date/ordinal-date", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-03-15",
"calendar": "valor-ejemplo"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/ordinal-date",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-03-15",
"calendar": "valor-ejemplo"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/ordinal-date", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-03-15","calendar":"valor-ejemplo"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-03-15","calendar":"valor-ejemplo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/ordinal-date", 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
{
"date": "2024-03-15",
"calendar": "valor-ejemplo"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.ordinal_date",
"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
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
Este convertidor de fecha ordinal ISO traduce YYYY-MM-DD a YYYY-DDD y en sentido inverso con aritmética gregoriana de bisiestos determinista, rechaza los valores de día del año que superan la longitud real del año y devuelve ambas representaciones junto con campos estructurados en un único payload JSON.
Forma calendario, forma ordinal y cuándo conviene cada dirección
Envíe una cadena de fecha, una cadena ordinal, año más mes más día, o año más day_of_year; los alias como calendar_date, ordinal_date, doy y ddd se aceptan cuando están documentados. No mezcle modos opuestos en una misma petición: el motor rechaza los payload ambiguos con invalid_input para que el llamador corrija el cuerpo en lugar de adivinar qué campo prevalece. Entradas idénticas producen siempre JSON idéntico porque el proceso nunca lee el reloj, la configuración regional ni la red.
Años bisiestos, longitud del año y errores de día del año no válido
Al convertir de ordinal a calendario, cualquier día del año menor que uno o mayor que la longitud del año falla con invalid_input y un mensaje que indica los días reales de ese año; por ejemplo, el día 366 de 2023 supera la longitud del año. La respuesta incluye is_leap_year y days_in_year para que los paneles muestren los datos del año sin una segunda llamada.
Uso de la API, precios, flujos de trabajo y límites prácticos
Llame al convertidor gratuito de fecha ordinal ISO en el navegador para comprobar tareas, demos de entrada de datos y verificaciones rápidas sin instalar bibliotecas de calendario. Los límites de año siguen el rango de parámetros publicado por seguridad de aislamiento y por las herramientas ISO civiles habituales. Envíe un cuerpo JSON con un único modo claro: date como YYYY-MM-DD, ordinal como YYYY-DDD, year month day estructurados, o year y day_of_year estructurados. Si la operación tiene éxito, el payload incluye calendar_date, ordinal_date, los componentes numéricos, direction igual a to_ordinal o to_calendar, calendar igual a gregorian y method igual a iso_ordinal_date, para los enrutadores y tests que ramifican según las etiquetas. Use la API de prepago cuando una plataforma logística, un pipeline científico, un archivo de cumplimiento o un SDK necesite un contrato estable con saldo KIT a $0.002 por elemento exitoso; los fallos de validación nunca consumen saldo tras el rechazo del motor. Combine este endpoint con herramientas de días por mes cuando solo necesite la longitud de febrero, o con formateadores cuando el siguiente paso sea mostrar de forma localizada una fecha de calendario ya normalizada.
Casos de integración
Índices de día científicos y de sensores
Los pipelines de investigación almacenan muestras como año más día del año; conviértalas a fechas de calendario para informes y de vuelta a forma ordinal para archivos compactos sin desviaciones del objeto Date del anfitrión.
Preguntas técnicas
¿Cómo convierto YYYY-MM-DD a una fecha ordinal ISO?
Envíe un JSON con date con una cadena de calendario como 2024-03-15, o envíe year, month y day. La respuesta incluye ordinal_date como YYYY-DDD y day_of_year como entero.
¿Cómo convierto YYYY-DDD de vuelta a una fecha de calendario?
Envíe ordinal como 2024-075, o envíe year más day_of_year. La respuesta devuelve calendar_date como YYYY-MM-DD con month y day ya calculados.
¿Usa el objeto Date de JavaScript o zonas horarias?
No. La conversión usa aritmética pura de años bisiestos gregorianos y longitudes acumuladas de mes, de modo que los resultados son idénticos en cualquier entorno y seguros para tests golden.