Vår kalendermetodologi

1. Deterministisk multikalendermotor

Helgdagar världen över följer olika matematiska och kulturella system. Vår pipeline modellerar fyra primära kalendermekanismer:

Fasta gregorianska datum: Nationaldagar och historiska årsdagar som infaller på fasta kalenderdatum (t.ex. 4 juli, 1 januari).

Astronomiska & equinoctiala beräkningar: Solstånd, dagjämningar och soltermer beräknade med exakta celestia koordinater.

Mån- och lunisolarkalendrar: Islamiska Hijri-kalendrar, kinesiska nyåret, Diwali och buddhistiska högtider beräknade via standardmodeller för månfasers synlighet och verifierade mot nationella religiösa auktoriteters proklamationer.

Computus-algoritmer: Västerländska (gregorianska) och östortodoxa (julianska) påskcykler och deras rörliga helgdagar (långfredagen, Kristi himmelsfärdsdag, annandag pingst, corpus Christi).

2. Lagstiftning & officiella dekret

Matematiska modeller ger råa datum, men lagar styr rätten till ledighet. Vi korsrefererar varje beräknad händelse mot primära rättsliga instrument: nationella arbetslagar, parlamentslagar, officiella statliga kungörelser och exekutiva order.

Där standardbibliotek utelämnar lagändringar eller använder utdaterade regler, säkerställer vårt register för manuella åsidosättanden (data/holiday-overrides.ts) verifierade lagstadgade korrigeringar.

3. Ersättningsdagar & modellering av helgförskjutningar

En av de viktigaste aspekterna av helgdagsplanering är att fastställa vad som händer när en lagstadgad helgdag infaller på en helg.

Vår motor kodar systematiskt nationella kompensationsregler: automatiska skift till efterföljande måndag (t.ex. Storbritannien, Australien, USA), skift till föregående fredag eller regler om nästa tillgängliga arbetsdag (t.ex. Albanien, Sydafrika), vilket säkerställer korrekta arbetsdagsberäkningar.

4. Kontinuerliga lagstiftningsgranskningar & regressionstester

Varje landskalender är föremål för automatiserad ögonblicksbildsvalidering (npm run holidays:validate:snapshots) för att förhindra regression, medan vår kontinuerliga övervakningspipeline spårar nyligen stiftade lagar, enskilda bankhelgdagar och kungliga eller presidentiella dekret världen över.