Número de semana con primer día a medida

Úselo gratis en el navegador para tableros de planificación y calendarios por región, o invoque la API a $0.002 por solicitud correcta cuando sus canalizaciones necesiten la misma etiqueta de semana siempre.

Qué es un número de semana con inicio personalizado y qué devuelve la respuesta

Usted pasa date como cadena estricta YYYY-MM-DD y first_weekday opcional como nombre en inglés (sunday a saturday) o un entero de cero para domingo a seis para sábado; si omite first_weekday, se asume lunes. Tras la validación, la respuesta repite la fecha normalizada, año civil, mes y día, el ordinal day_of_year, el día de la semana de la entrada en minúsculas y en Title Case más un índice basado en cero, first_weekday y first_weekday_index resueltos, cuántos días separan la fecha del inicio de su semana, week_number desde uno hacia arriba, weeks_in_year como el número de semana del 31 de diciembre con el mismo día de inicio, week_1_rule igual a contains_january_1, indicadores de bisiesto y calendario, una etiqueta method y una fórmula breve para documentación. No hay conversión de huso horario ni dependencia de “hoy”: o las entradas forman un día de calendario real y un primer día válido, o la solicitud falla con invalid_input.

Cómo se leen la fecha y el primer día para que el resultado sea reproducible

La cadena debe coincidir con cuatro dígitos, un guion, dos dígitos, otro guion y dos dígitos; se recortan espacios al inicio y al final, pero aquí no se expanden fechas parciales, nombres de mes ni el ordinal del día del año solo. 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, con bisiestos según la regla gregoriana (divisible por cuatro salvo siglos no divisibles por cuatrocientos). El campo preferido de fecha es date, pero se aceptan los alias iso_date, d, value y calendar para que hojas de cálculo, cadenas de consulta y formularios reutilicen el contrato sin renombrar columnas. El campo first_weekday acepta nombres o índices numéricos y tiene alias week_start, start_day y first_day; valores vacíos u omitidos default a lunes para que un inicio estilo ISO esté a un paso sin forzar la regla de año-semana ISO. Del triple validado el motor calcula day_of_year sumando longitudes de mes con ajuste de febrero bisiesto, luego los días de la semana de la fecha de entrada y del 1 de enero con el método entero de Sakamoto (domingo cero, sábado seis). El desfase del 1 de enero dentro de la semana personalizada es (día del 1 de enero menos first_weekday más siete) módulo siete; el número de semana es el suelo de day_of_year menos uno más ese desfase, todo dividido por siete, más uno. El número de semana del 31 de diciembre con el mismo inicio se devuelve como weeks_in_year para que los paneles sepan si el año llega a 52, 53 o 54 etiquetas con esa configuración. Combine la ejecución gratuita del navegador en esta página con la API de pago cuando necesite la misma etiqueta de semana dentro de una canalización automatizada.

Dónde encajan los números de semana con inicio personalizado en planificación e informes

Los analistas que construyen paneles año a año pueden guardar week_number junto con first_weekday_index para que los filtros sigan siendo inequívocos cuando dos regiones no coinciden en el inicio de semana. En esta página el trabajo corre por completo en su navegador; por la API cada consulta correcta cuesta $0.002, la validación fallida no se cobra y no se almacena nada tras la respuesta. Esa división—exploración interactiva gratuita y API idéntica de pago—coincide con el resto del catálogo KIT de nivel A y le permite pasar de una comprobación puntual a una canalización sin cambiar el resultado matemático.