Calculadora de semana ISO
Escriba una fecha y vea su semana ISO: el 1 de enero de 2024 es la semana 1 de 2024, pero el 1 de enero de 2021 sigue en la semana 53 de 2020. También verá el año-semana. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Fecha
- 2024-01-01
- Año
- 2 024
- Mes
- 1
- Día
- 1
- Semana ISO
- 1
Esta calculadora de número de semana ISO toma una única fecha del calendario gregoriano en formato YYYY-MM-DD y devuelve su número de semana ISO-8601 junto con el año de numeración de semana al que pertenecen esos dos valores. Las semanas ISO siempre comienzan el lunes y terminan el domingo, y la semana 1 de un año es la semana que contiene el primer jueves de ese año, razón por la cual finales de diciembre y comienzos de enero a menudo reportan un año-semana distinto del año civil que aparece en el calendario. Entre las comprobaciones clásicas están 2024-01-01, que corresponde a la semana 1 de 2024, y 2021-01-01, que corresponde a la semana 53 de 2020. El motor usa únicamente aritmética de calendario entera y determinista: los años bisiestos, las longitudes de mes, el día del año ordinal y el día de la semana ISO se calculan sin llamadas de red, sin muestreo aleatorio y sin depender del reloj del sistema.
Qué es un número de semana ISO y qué contiene la respuesta
Las fechas de semana ISO-8601 responden una pregunta distinta a los calendarios de mes y día: ubican un día dentro de una semana basada en el lunes, numerada de 1 a 52 o 53 dentro de un año de numeración de semana. La semana 1 se define como la semana que contiene el primer jueves del año, lo que equivale a la semana que contiene el 4 de enero.
Por esa regla, del 29 de diciembre al 3 de enero pueden pertenecer al año-semana anterior o siguiente, incluso cuando el año civil de la factura todavía diga el número antiguo o el nuevo. Si necesita épocas Unix, análisis de múltiples formatos, o aritmética de días hábiles, utilice esas herramientas específicas; esta página responde únicamente el número de semana ISO y el año-semana de una fecha de calendario validada.
Cómo se interpreta la fecha y cómo la semana se mantiene reproducible
La cadena debe coincidir con cuatro dígitos, un guion, dos dígitos, otro guion y dos dígitos; los espacios al inicio o al final se recortan, pero las fechas parciales, el día del año ordinal solo, y los nombres de mes no se expanden aquí.
Tras el análisis, el año debe estar entre 1 y 9999, el mes entre 1 y 12, y el día entre 1 y la longitud real de ese mes en ese año, siguiendo los años bisiestos la regla gregoriana de divisible entre cuatro salvo los años seculares no divisibles entre cuatrocientos.
A partir de la terna validada, el motor calcula el día del año sumando las longitudes de mes, el día de la semana ISO mediante el método entero puro de Sakamoto, asignado de modo que el lunes sea uno y el domingo sea siete, y luego el número de semana como el piso de día del año menos día de la semana más diez, todo dividido entre siete.
Cuando esa semana es menor que uno, la fecha pertenece a la última semana del año-semana anterior; cuando supera el número de semanas del año civil, pertenece a la semana uno del año-semana siguiente. Un año tiene cincuenta y tres semanas ISO cuando su primer o último día es jueves.
Dónde encajan los números de semana ISO en la planificación, los reportes y el software
Los equipos de operaciones y finanzas usan números de semana ISO cuando una cadencia semanal debe alinearse entre países que no todos comienzan la semana en domingo: los cronogramas de fabricación, los paquetes de venta minorista, las etiquetas de sprint ágil y los reportes estatutarios que citan semana del año se benefician de un identificador de semana único e inequívoco.
Los desarrolladores llaman al mismo contrato desde scripts para sellar cubos de registros, para generar vectores de prueba deterministas para sistemas de nómina y hojas de horario, o para satisfacer requisitos de producto que exigen etiquetas W01 a W53 en lugar de una numeración de semana local improvisada.
Los educadores y los redactores de normas usan la herramienta para demostrar fechas límite como 2005-01-01 en la semana 53 de 2004 frente a 2005-01-03 en la semana 1 de 2005, sin depender de números de serie de hojas de cálculo que difieren entre Excel e ISO. Combínela con la conversión de época o la normalización de fechas cuando necesite pasos de calendario relacionados, y con otros ayudantes deterministas y gratuitos cuando esté construyendo un pequeño laboratorio de utilidades de fecha.
Qué puede hacer con ella
Etiquetas de reportes semanales
Selle paneles, paquetes minoristas y reportes de operaciones con pares estables de semana y año ISO, en lugar de semanas locales dependientes del idioma.
Comprobaciones de cumplimiento en el límite del año
Verifique fechas de finales de diciembre y comienzos de enero que pertenecen al año-semana anterior o siguiente antes de cerrar libros o presentar estadísticas por semana.
Preguntas frecuentes
¿Cuánto cuesta la calculadora de número de semana ISO?
Es gratis en su navegador, en esta página.
¿Cómo se define el número de semana ISO?
Las semanas van de lunes a domingo. La semana 1 es la que contiene el primer jueves del año (la semana que contiene el 4 de enero). El resultado puede usar un año-semana distinto del año civil.
¿Esto convierte zonas horarias o usa el reloj actual?
No. Solo relaciona una fecha de calendario validada con campos de semana ISO mediante aritmética pura.
¿Por qué el 1 de enero de 2021 cae en la semana 53 de 2020?
Porque la semana 1 de un año es la que contiene su primer jueves, y el 1 de enero de 2021 queda antes de ella. Ese día pertenece todavía a la última semana de 2020, que fue la 53.
¿Qué más muestra el resultado además del número de semana?
Muestra el día de la semana del 1 (lunes) al 7 (domingo) con su nombre, una etiqueta corta como 2024-W01, cuántas semanas tiene ese año-semana y el número de día dentro del año.
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/iso-week-number \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2024-01-01"}'const res = await fetch("https://api.kit.forhosting.com/date/iso-week-number", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"date": "2024-01-01"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/iso-week-number",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"date": "2024-01-01"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/iso-week-number", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"date":"2024-01-01"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"date":"2024-01-01"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/iso-week-number", 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-01-01"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.iso_week_number",
"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.
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
Utilícela gratis en el navegador para planificación, nómina y hojas de cumplimiento normativo, o llame a la API por $0.002 por solicitud exitosa cuando necesite etiquetas de semana reproducibles en integración continua, canalizaciones de reportes o funciones de producto.
Qué es un número de semana ISO y qué contiene la respuesta
Esta calculadora acepta un campo obligatorio, date, como cadena estricta YYYY-MM-DD, valida que el día exista realmente en el calendario gregoriano —incluido el 29 de febrero solo en años bisiestos y la longitud correcta de cada mes— y luego devuelve la fecha normalizada, el año, mes y día civiles, el número de semana ISO como iso_week, el año de numeración de semana como iso_week_year, el día de la semana ISO de 1 para lunes a 7 para domingo con un nombre legible, una cadena compacta iso_week_string como 2020-W53, cuántas semanas contiene ese año-semana, el ordinal día del año, y un breve recordatorio de la fórmula. No hay conversión de zona horaria, ni primer día de semana dependiente del idioma, ni aproximación de punto flotante: o la entrada es un día real del calendario y los campos de semana quedan totalmente determinados, o la solicitud falla con invalid_input. Los casos rechazados incluyen date ausente, formato incorrecto como 2024/01/01, meses imposibles, y días que no existen como 2023-02-29.
Cómo se interpreta la fecha y cómo la semana se mantiene reproducible
El campo preferido es date, pero se aceptan los alias iso_date, d y value, de modo que hojas de cálculo, cadenas de consulta y formularios tipados puedan reutilizar el mismo contrato sin renombrar columnas. Combine la ejecución gratuita en el navegador de esta página con la API de pago cuando necesite la misma etiqueta de semana dentro de un flujo automatizado.
Dónde encajan los números de semana ISO en la planificación, los reportes y el software
Los analistas que construyen paneles interanuales evitan el clásico error de desfase de uno, en el que los primeros días de enero todavía pertenecen a la semana 52 o 53 del año-semana anterior, si almacenan tanto iso_week como iso_week_year en lugar de solo el año civil. 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 comprobación puntual a un flujo automatizado sin cambiar el resultado matemático.
Casos de integración
Fixtures de prueba deterministas
Genere valores reproducibles de iso_week e iso_week_string para pruebas unitarias, comprobaciones de propiedades y aserciones de integración continua sin desviación de Date.
Preguntas técnicas
¿Por qué iso_week_year puede diferir del año de calendario?
Las fechas de aproximadamente el 29 de diciembre al 3 de enero suelen caer en la última semana del año-semana anterior o en la semana 1 del siguiente, bajo las reglas de ISO-8601.
¿Qué formatos de fecha se admiten?
Solo fechas de calendario estrictas YYYY-MM-DD. Valores como 2024/01/01, 01-01-2024, o 2023-02-29 (año no bisiesto) se rechazan con invalid_input.