ForHosting KIT · Fechas y tiempo

Conversor de semana ISO a fecha

Convierta una etiqueta de semana ISO en un día real: el lunes de la semana 1 de 2024 es el 1 de enero de 2024, y el de la semana 1 de 2015 retrocede al 29 de diciembre de 2014. 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

Año: 2 024
Semana: 1
Día de la semana: 1

Obtiene

Nombre del día: Monday
Fecha: 2024-01-01
Año de calendario: 2 024
Mes: 1

Este conversor de semana ISO a fecha relaciona un año de numeración de semana ISO-8601, un número de semana de uno a cincuenta y dos o cincuenta y tres, y un día ISO desde lunes igual a uno hasta domingo igual a siete, con el día de calendario gregoriano correspondiente en formato YYYY-MM-DD. La numeración de semana ISO es el estándar usado en logística, calendarios de nómina, cronogramas de fabricación y muchos sistemas empresariales europeos: la semana uno siempre contiene el cuatro de enero, las semanas siempre comienzan el lunes, y algunos años tienen una quincuagésima tercera semana. Puede que ya sepa que el lunes de la semana 1 de 2024 es 2024-01-01, que el lunes de la semana 1 de 2015 cae en diciembre de 2014, y que una solicitud de la semana 53 de un año de cincuenta y dos semanas debe fallar.

Qué devuelve la conversión de semana ISO a fecha y cuándo falla

La numeración de semana ISO-8601 identifica un día mediante tres números: el año de numeración de semana Y, el número de semana W de uno hasta la última semana de ese año, y el día de la semana D, donde el lunes es uno y el domingo es siete.

La semana uno del año Y se define como la semana que contiene el cuatro de enero de Y, que también es la semana que contiene el primer jueves de Y; a partir de ese ancla, el motor avanza o retrocede semanas y días completos. Cerca de los límites de año, el año gregoriano del resultado puede diferir del año-semana ISO: por ejemplo, el lunes de 2015-W01 es 2014-12-29, y el viernes de 2020-W53 es 2021-01-01.

También se rechazan los valores ausentes o no enteros de año, semana o día de la semana, los días de la semana fuera de uno a siete, y los años fuera del rango admitido de uno a nueve mil novecientos noventa y nueve.

Cómo se interpretan el año, la semana y el día de la semana, y cómo la fecha se mantiene reproducible

Las cadenas enteras y los bigints seguros se aceptan cuando se interpretan como números enteros dentro de los rangos documentados; los decimales, las cadenas vacías y los tokens no numéricos se rechazan para que una celda mal escrita no se convierta en un día de envío equivocado.

El cálculo comienza en el cuatro de enero del año-semana, encuentra su día de la semana ISO con aritmética entera pura al estilo Sakamoto, retrocede hasta el lunes de la semana uno, y luego suma siete por semana menos uno más día de la semana menos uno, en días. Los ordinales que caen antes del primero de enero o después del último de diciembre se normalizan a través de los límites de año gregoriano con manejo completo de años bisiestos, incluida la regla de los cuatrocientos años.

Dónde encaja la conversión de semana a fecha en la planificación, la logística y el software

Los equipos de operaciones se encuentran con etiquetas de semana ISO en órdenes de compra, ventanas de entrega y planes de producción que dicen semana cuarenta y dos sin nombrar un mes. Los calendarios de finanzas y de recursos humanos a menudo cierran periodos por semana ISO, y las herramientas de reportes deben convertir esas etiquetas en fechas concretas de inicio y fin para filtros y exportaciones.

Los desarrolladores llaman al mismo contrato desde scripts para sembrar vectores de prueba deterministas para selectores de fecha, para normalizar cadenas de semana introducidas por el usuario antes de almacenarlas, o para satisfacer enunciados de retos de programación que exigen un día de calendario en lugar de una aproximación hecha a mano. Los educadores lo usan al enseñar ISO-8601: los estudiantes pueden verificar que la semana uno siempre cubre el cuatro de enero y que solo los años largos aceptan la semana cincuenta y tres.

Las herramientas de producto e integración usan la conversión cuando un formulario recopila año, semana y día de la semana, y el backend debe almacenar un único YYYY-MM-DD para ordenar y unir datos.

Qué puede hacer con ella

Cronogramas de logística y producción

Convierta etiquetas de semana ISO de órdenes y planes en fechas concretas de envío y producción en formato YYYY-MM-DD.

Calendarios de nómina y reportes

Resuelva periodos de semana ISO en días de inicio y fin gregorianos para filtros, exportaciones y cierres de periodo.

Preguntas frecuentes

¿Cuánto cuesta el conversor de semana ISO a fecha?

Es gratis en su navegador, en esta página.

¿Cuándo se rechaza la semana 53?

Cuando el año-semana ISO solo tiene 52 semanas.

¿El año de calendario puede diferir del año-semana ISO?

Sí. Los días cercanos a los límites de año a menudo caen en el año gregoriano anterior o siguiente, mientras aún pertenecen al año-semana ISO solicitado.

¿Esta herramienta convierte una fecha de calendario en una semana ISO?

No. Solo relaciona año-semana, semana y día de la semana con una fecha. Use la calculadora de número de semana ISO para la dirección inversa.

¿Qué significan los tres números que se escriben?

El primero es el año-semana ISO, el segundo el número de semana, del 1 al 52 o 53, y el tercero el día, del 1 para el lunes al 7 para el domingo. Así, 2024, 1 y 1 dan el 1 de enero de 2024.

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/iso-week-to-date

¿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/iso-week-to-date \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2024,"week":1,"weekday":1}'

const res = await fetch("https://api.kit.forhosting.com/date/iso-week-to-date", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "year": 2024,
    "week": 1,
    "weekday": 1
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/iso-week-to-date",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 2024,
    "week": 1,
    "weekday": 1
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/iso-week-to-date", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"year":2024,"week":1,"weekday":1}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"year":2024,"week":1,"weekday":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/iso-week-to-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

{
  "year": 2024,
  "week": 1,
  "weekday": 1
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.iso_week_to_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

Por solicitud$0.002

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

Límites

`year_min`	1
`year_max`	9999

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

Qué devuelve la conversión de semana ISO a fecha y cuándo falla

Este conversor resuelve esa terna en una única cadena de fecha de calendario en formato extendido YYYY-MM-DD, más campos estructurados de año, mes y día civiles, el nombre del día de la semana en formato legible, la cadena canónica iso_week_string como 2024-W01, y el conteo weeks_in_iso_year usado para la validación. La solicitud se rechaza con invalid_input cuando el número de semana supera el conteo de semanas del año —la mayoría de los años tienen cincuenta y dos semanas, y solo los años cuyo primer o último día es jueves tienen cincuenta y tres— así que la semana cincuenta y tres de 2024 falla porque 2024 solo tiene cincuenta y dos semanas.

Cómo se interpretan el año, la semana y el día de la semana, y cómo la fecha se mantiene reproducible

Los campos preferidos son year para el año de numeración de semana ISO, week para el número de semana, y weekday para el día de la semana ISO, con los alias iso_week_year, week_year, y y para year; iso_week, week_number, y w para week; e iso_weekday, day, y dow para weekday, de modo que hojas de cálculo, cadenas de consulta y formularios tipados puedan reutilizar el mismo contrato. Combine la ejecución gratuita en el navegador de esta página con la API de pago cuando necesite el mismo resultado matemático dentro de un flujo automatizado, un conector de ERP o un generador de calendario de nómina, sin distribuir una segunda biblioteca de calendario.

Dónde encaja la conversión de semana a fecha en la planificación, la logística y el software

En esta página el trabajo se ejecuta enteramente en su navegador; a través de la API, cada consulta exitosa cuesta $0.002, la validación fallida no se cobra, y no se almacena nada después de que se devuelve la respuesta. Esa división —exploración interactiva gratuita y una API de pago idéntica— coincide con el resto del catálogo tier A del KIT y le permite pasar de una demostración de planificación a un flujo automatizado sin cambiar el resultado matemático. Combínelo con la calculadora de número de semana ISO cuando necesite la relación inversa, de una fecha de calendario a semana y año-semana, y con otros endpoints de fecha cuando esté construyendo un pequeño laboratorio de ayudantes de calendario gratuitos y deterministas.

Casos de integración

Fixtures de prueba deterministas

Genere fechas de calendario reproducibles a partir de ternas año/semana/día de la semana para pruebas unitarias y aserciones de integración continua.

Preguntas técnicas

¿Cómo se definen el año, la semana y el día de la semana?

Year es el año de numeración de semana ISO, week es de 1 a 52 o 53, y weekday es lunes=1 hasta domingo=7 según ISO-8601.

Ver la documentación completa del KIT →

Ejecutar — gratis

Ejemplo resuelto

Qué devuelve la conversión de semana ISO a fecha y cuándo falla

Cómo se interpretan el año, la semana y el día de la semana, y cómo la fecha se mantiene reproducible

Dónde encaja la conversión de semana a fecha en la planificación, la logística y el software

Qué puede hacer con ella

Cronogramas de logística y producción

Calendarios de nómina y reportes

Preguntas frecuentes

Herramientas relacionadas

Para desarrolladores — acceso por API

Endpoint de API

Llámela desde su stack

Ejemplo de solicitud

Ejemplo de respuesta

Precio

Límites

Errores

Notas técnicas

Qué devuelve la conversión de semana ISO a fecha y cuándo falla

Cómo se interpretan el año, la semana y el día de la semana, y cómo la fecha se mantiene reproducible

Dónde encaja la conversión de semana a fecha en la planificación, la logística y el software

Casos de integración

Fixtures de prueba deterministas

Preguntas técnicas

gracias