ForHosting KIT · Fechas y tiempo

Inicio y fin de semana ISO

Escriba cualquier día y obtenga el lunes que abre su semana ISO y el domingo que la cierra: el 3 de enero de 2024 está en la semana del 1 al 7 de enero de 2024. Ambas fechas cuentan. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Fecha
2024-01-03
Obtiene
Año
2 024
Mes
1
Día
3
Día de la semana ISO
3

Esta calculadora de inicio y fin de semana ISO toma una única fecha del calendario gregoriano en formato YYYY-MM-DD y devuelve el lunes que abre la semana ISO-8601 que contiene ese día y el domingo que la cierra. Las semanas ISO siempre van de lunes a domingo y no dependen del primer día de la semana del idioma o la región, por eso la nómina, los packs de fabricación, las etiquetas de sprint ágil y los reportes transfronterizos las prefieren frente a las semanas estilo EE. UU. que empiezan en domingo. Entre las comprobaciones clásicas están 2024-01-03, que corresponde a la semana del 2024-01-01 al 2024-01-07, y 2021-01-01, que corresponde a la semana del 2020-12-28 al 2021-01-03 porque ese viernes sigue perteneciendo a la semana 53 del año-semana 2020. El motor usa únicamente aritmética de calendario entera y determinista: años bisiestos, longitudes de mes, día de la semana ISO, desplazamientos de número de día juliano y reglas de límite de número de semana se calculan sin llamadas de red, sin muestreo aleatorio y sin el reloj del sistema.

Qué significan el inicio y el fin de una semana ISO y qué contiene la respuesta

Las fechas de semana ISO-8601 ubican un día civil dentro de una ventana de siete días 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, finales de diciembre y comienzos de enero pueden pertenecer a un año-semana distinto del año civil impreso en la factura, y el lunes de inicio o el domingo de cierre pueden caer en un mes o año de calendario distinto del día de entrada.

Si necesita un primer día de semana personalizado, solo el número de semana, o la conversión de año-semana más semana en una fecha, use esas herramientas específicas; esta página responde únicamente los límites de la ventana de semana ISO para una fecha de calendario validada.

Cómo se lee la fecha y cómo la ventana lunes–domingo 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.

La misma ruta también deriva el número de semana ISO como el piso de día del año menos día de la semana más diez, todo dividido entre siete, con ajuste de año-semana cuando la semana provisional es menor que uno o supera el número de semanas del año civil. Un año tiene cincuenta y tres semanas ISO cuando su primer o último día es jueves.

Rangos de fechas para reportes semanales

Convierta cualquier día de factura o de registro en límites inclusivos lunes–domingo ISO para paneles, packs minoristas y reportes de operaciones.

Ventanas de semana en el límite del año

Resuelva fechas de finales de diciembre y comienzos de enero cuya semana ISO empieza o termina en un año civil distinto antes de cerrar libros.

¿Cuánto cuesta la calculadora de inicio y fin de semana ISO?

Es gratuita en su navegador en esta página.

¿Por qué el lunes o el domingo pueden caer en otro mes o año?

Las semanas ISO son bloques continuos de siete días. Un miércoles de principios de enero puede pertenecer aún a una semana que comenzó a finales de diciembre del año civil anterior.

¿Convierte zonas horarias o usa el reloj actual?

No. Solo asigna una fecha de calendario validada a límites lunes–domingo de semana ISO con aritmética pura.

¿El lunes y el domingo están incluidos en el rango?

Sí. Los dos extremos cuentan, así que el intervalo siempre abarca siete días: para el 3 de enero de 2024 va del lunes 1 al domingo 7 de enero, listo para un informe semanal.

¿Puedo hacer que la semana empiece en domingo?

No. La semana ISO siempre va de lunes a domingo y ese inicio no se puede cambiar, lo que mantiene alineados los informes de distintos países. Para semanas que empiezan en domingo, use una herramienta pensada para esa convención.

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.

POSThttps://api.kit.forhosting.com/date/iso-week-start-end

¿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.

curl -X POST https://api.kit.forhosting.com/date/iso-week-start-end \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2024-01-03"}'
{
  "date": "2024-01-03"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.iso_week_start_end",
  "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.

Por solicitud$0.002

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

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Utilícela gratis en el navegador para hojas de planificación y controles de cumplimiento, o llame a la API por $0.002 por solicitud exitosa cuando necesite límites de ventana semanal reproducibles en integración continua, canalizaciones de reportes o funciones de producto.

Qué significan el inicio y el fin de una 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 día de la semana ISO de 1 para lunes a 7 para domingo con un nombre legible, cuántos días después del lunes se sitúa la entrada, week_start y week_end como fechas ISO inclusivas, el número de semana ISO y el año-semana con una cadena compacta iso_week_string como 2020-W53, cuántas semanas contiene ese año-semana, el ordinal día del año, anclas de número de día juliano para la entrada y los extremos de la semana, length_days igual a siete, y un breve recordatorio de la fórmula. No hay conversión de zona horaria, ni primer día de semana configurable, ni aproximación de punto flotante: o la entrada es un día real del calendario y el par lunes–domingo queda totalmente determinado, o la solicitud falla con invalid_input. Los casos rechazados incluyen date ausente, formato incorrecto como 2024/01/03, meses imposibles, y días que no existen como 2023-02-29.

Cómo se lee la fecha y cómo la ventana lunes–domingo 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. A partir de la terna validada, el motor calcula 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, convierte el día civil a un número de día juliano astronómico con el algoritmo de Fliegel–Van Flandern, resta days_from_monday igual a iso_weekday menos uno para aterrizar en el lunes, y suma seis días para aterrizar en el domingo. Combine la ejecución gratuita en el navegador de esta página con la API de pago cuando necesite la misma ventana semanal dentro de un flujo automatizado.

Dónde encajan el inicio y el fin de semana ISO en la planificación, los reportes y el software

Los equipos de operaciones y finanzas necesitan el lunes y el domingo de una 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 packs de venta minorista, las etiquetas de sprint ágil y los reportes estatutarios que citan semana del año se benefician de una ventana inclusiva inequívoca. Los desarrolladores llaman al mismo contrato desde scripts para sellar cubos de registros, generar rangos por defecto de hojas de horario o producir vectores de prueba deterministas para sistemas de nómina que cierran el domingo por la noche. Los educadores y los redactores de normas usan la herramienta para demostrar fechas límite como 2005-01-01 dentro de una semana que comenzó en diciembre de 2004, sin depender de números de serie de hojas de cálculo que difieren entre Excel e ISO. Los analistas que construyen paneles interanuales evitan filtros con error de desfase de uno cuando almacenan tanto week_start como week_end en lugar de solo un número de semana que aún hay que expandir a predicados de fecha. 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. Combínela con la consulta de número de semana ISO cuando solo necesite el identificador de semana, con week_start_end configurable cuando importen los primeros días de semana del idioma, y con otros ayudantes deterministas y gratuitos cuando esté montando un pequeño laboratorio de utilidades de fecha.

Fixtures de prueba deterministas

Genere valores reproducibles de week_start y week_end para pruebas unitarias, comprobaciones de propiedades y aserciones de integración continua sin desviación de Date.

¿Qué días son week_start y week_end?

Según ISO-8601, week_start es siempre lunes y week_end es siempre domingo. No hay opción de empezar la semana en domingo ni en otro día.

¿Qué formatos de fecha se aceptan?

Solo fechas de calendario estrictas YYYY-MM-DD. Valores como 2024/01/03, 01-03-2024 o 2023-02-29 (no bisiesto) se rechazan con invalid_input.

Ver la documentación completa del KIT →