Nuestra metodología de calendarios
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 estatutarios.
1. Motor multicalendario determinista
Los días festivos en todo el mundo siguen diversos sistemas matemáticos y culturales. Nuestra canalización modela cuatro mecanismos de calendarios principales:
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 hégira, el Año Nuevo Chino, Diwali y observancias budistas calculadas mediante modelos estándar de visibilidad de las fases lunares y verificadas con las proclamaciones de las autoridades religiosas nacionales.
Algoritmos de computus: Ciclos de Pascua occidentales (gregorianos) y ortodoxos orientales (julianos) y sus fiestas 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 estimadas, pero las leyes estatutarias dictan el descanso legal. Contrastamos cada ocurrencia calculada con instrumentos legales principales: códigos laborales nacionales, leyes parlamentarias, gacetas oficiales del estado y órdenes ejecutivas.
Cuando las bibliotecas estándar omiten reformas estatutarias o utilizan reglas obsoletas, nuestro registro de anulación manual (data/holiday-overrides.ts) aplica correcciones estatutarias verificadas.
3. Modelado de días sustitutos y desplazamiento de fines de semana
Uno de los aspectos más críticos de la planificación de días festivos es determinar qué sucede cuando un día festivo estatutario coincide con un fin de semana.
Nuestro motor codifica sistemáticamente las reglas de compensación nacional: desplazamientos automáticos al lunes siguiente (p. ej., Reino Unido, Australia, EE. UU.), desplazamientos al viernes anterior o reglas del siguiente día hábil 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 nuestra canalización de monitoreo continuo rastrea leyes recién promulgadas, días festivos bancarios únicos y decretos reales o presidenciales en todo el mundo.