Nuestra metodología de calendario
Nuestro motor de calendarios combina algoritmos astronómicos y religiosos deterministas con una verificación continua frente a la legislación gubernamental principal y los decretos legales.
1. Motor multicalendario determinista
Los días festivos en todo el mundo siguen diversos sistemas matemáticos y culturales. Nuestro flujo modela cuatro mecanismos principales de calendario:
Fechas gregorianas fijas: Días nacionales y aniversarios históricos que caen en fechas fijas del calendario (p. ej., 4 de julio, 1 de enero).
Cálculos astronómicos y equinocciales: Solsticios, equinoccios y términos solares calculados mediante coordenadas celestes precisas.
Calendarios lunares y lunisolares: Calendarios islámicos Hijri, el Año Nuevo Chino, Diwali y las festividades budistas calculados mediante modelos estándar de visibilidad de las fases lunares y verificados frente a las proclamaciones de las autoridades religiosas nacionales.
Algoritmos del Cómputo Pascual: Ciclos de Pascua occidental (gregoriano) y ortodoxo oriental (juliano) y sus festividades móviles dependientes (Viernes Santo, Ascensión, Lunes de Pentecostés, Corpus Christi).
2. Legislación estatutaria y decretos oficiales
Los modelos matemáticos proporcionan fechas en bruto, pero las leyes estatutarias dictan el descanso legal. Cruzamos cada aparición calculada con instrumentos jurídicos principales: códigos laborales nacionales, leyes parlamentarias, boletines oficiales del Estado y órdenes ejecutivas.
Cuando las bibliotecas estándar omiten reformas legales o utilizan normas obsoletas, nuestro registro de anulación manual (data/holiday-overrides.ts) aplica correcciones estatutarias verificadas.
3. Días sustitutorios y modelización de cambios de fin de semana
Uno de los aspectos más críticos de la planificación de festivos es determinar qué sucede cuando un día festivo oficial coincide con un fin de semana.
Nuestro motor codifica sistemáticamente las normas compensatorias nacionales: cambios automáticos al lunes siguiente (p. ej., Reino Unido, Australia, EE. UU.), cambios al viernes anterior o normas del siguiente día laborable disponible (p. ej., Albania, Sudáfrica), lo que garantiza recuentos precisos de días laborables.
4. Auditorías legislativas continuas y pruebas de regresión
El calendario de cada país está sujeto a una validación automatizada de instantáneas (npm run holidays:validate:snapshots) para evitar regresiones, mientras que nuestro canal de seguimiento continuo rastrea las leyes recién promulgadas, los días festivos bancarios puntuales y los decretos reales o presidenciales en todo el mundo.