Meie kalendri metoodika

1. Deterministlik mitme kalendri mootor

Riigipühad üle maailma järgivad erinevaid matemaatilisi ja kultuurilisi süsteeme. Meie süsteem modelleerib nelja peamist kalendrimehhanismi:

Fikseeritud Gregoriuse kalendri kuupäevad: Rahvuspühad ja ajaloolised aastapäevad, mis langevad fikseeritud kalendrikuupäevadele (nt 4. juuli, 1. jaanuar).

Astronoomilised ja ekvinoktsiaalsed arvutused: Pööripäevad, võrdpäevsused ja päikeseterminitel põhinevad arvutused, mis kasutavad täpseid taevakoordinaate.

Kuukalendrid ja kuupäikesekalendrid: Islami hidžra kalender, Hiina uusaasta, Diwali ja budistlikud tähtpäevad, mis on arvutatud standardsete kuufaaside nähtavuse mudelite abil ja mida on kontrollitud riiklike usuliste asutuste proklamatsioonide alusel.

Arvutusalgoritmid (Computus): Lääne (Gregoriuse) ja Ida-Õigeusu (Juuliuse) ülestõusmispühade tsüklid ja nendest sõltuvad liikuvad pühad (suur reede, taevaminemispüha, nelipühade esmaspäev, Kristuse Pühima Keha ja Vere püha).

2. Seadusandlikud aktid ja ametlikud dekreedid

Matemaatilised mudelid annavad toorkuupäevad, kuid seadused dikteerivad juriidilise puhkuse. Me ristkontrollime kõiki arvutatud sündmusi esmaste õigusaktidega: riiklike tööseadustikega, parlamendi seadustega, ametlike riigiteatajate ja täidesaatva võimu korraldustega.

Kui standardteegid jätavad seadusandlikud reformid välja või kasutavad aegunud reegleid, jõustab meie käsitsi ülekirjutamise register (data/holiday-overrides.ts) kontrollitud seadusjärgsed parandused.

3. Asenduspäevad ja nädalavahetuse nihke modelleerimine

Pühade planeerimise üks kriitilisemaid aspekte on kindlaks teha, mis juhtub siis, kui riigipüha langeb nädalavahetusele.

Meie mootor kodeerib süstemaatiliselt riiklikud hüvitusreeglid: automaatsed nihked järgmisele esmaspäevale (nt Ühendkuningriik, Austraalia, USA), nihked eelnevale reedele või järgmise saadaoleva tööpäeva reeglid (nt Albaania, Lõuna-Aafrika Vabariik), tagades tööpäevade täpse arvu.

4. Pidevad seadusandlikud auditid ja regressioonitestimine

Iga riigi kalender läbib automatiseeritud hetktõmmiste valideerimise (npm run holidays:validate:snapshots), et vältida regressiooni, samas kui meie pideva jälgimise torujuhe hoiab silma peal äsja jõustunud seadustel, ühekordsetel pangapühadel ning kuninglikel või presidendi dekreetidel üle maailma.