Naša koledarska metodologija

1. Deterministični večkoledarski mehanizem

Dela prosti dnevi po vsem svetu sledijo različnim matematičnim in kulturnim sistemom. Naš cjevovod modelira štiri primarne koledarske mehanizme:

Fiksni gregorijanski datumi: Državni prazniki in zgodovinske obletnice, ki padejo na določene koledarske datume (npr. 4. julij, 1. januar).

Astronomski in enakonočni izračuni: Sončni obrati, enakonočja in sončne dobe, izračunani z uporabo natančnih nebesnih koordinat.

Lunarni in lunisolarni koledarji: Islamski hidžri koledar, kitajsko lunarno novo leto, divali in budistična praznovanja, izračunana prek standardnih modelov vidljivosti luninih men in preverjena z razglasitvami nacionalnih verskih oblasti.

Algoritmi Computus: Ciklusi zahodne (gregorijanske) in vzhodne pravoslavne (julijanske) velikonočne nedelje ter z njimi povezani premikajoči se prazniki (veliki petek, vnebohod, binkoštni ponedeljek, sveto rešnje telo).

2. Zakonodaja in uradni odloki

Matematični modeli nudijo surove datume, vendar zakonodaja narekuje zakonski počitek. Vsak izračunani pojav navzkrižno preverjamo s primarnimi pravnimi instrumenti: nacionalnimi delovnimi zakoniki, parlamentarnimi zakoni, uradnimi listi in izvršnimi odredi.

Kjer standardne knjižnice opuščajo zakonske reforme ali uporabljajo zastarela pravila, naš register ročnih preglasitev (data/holiday-overrides.ts) uveljavlja preverjene zakonske popravke.

3. Nadomestni dnevi in modeliranje premikov vikendov

Eden najpomembnejših vidikov načrtovanja praznikov je ugotavljanje, kaj se zgodi, ko se zakonski praznik ujema z vikendom.

Naš mehanizem sistematično kodira nacionalna pravila nadomestila: samodejne premike na naslednji ponedeljek (npr. Združeno kraljestvo, Avstralija, ZDA), premike na prejšnji petek ali pravila naslednjega razpoložljivega delovnega dne (npr. Albanija, Južna Afrika), kar zagotavlja točne izračune delovnih dni.

4. Nenehne zakonodajne revizije in testiranje regresije

Koledar vsake države je predmet samodejnega preverjanja posnetkov (npm run holidays:validate:snapshots), da se prepreči regresija, medtem ko naš cjevovod za nenehno spremljanje sledi na novo sprejetim zakonom, enkratnim bančnim praznikom ter kraljevim ali predsedniškim odlokom po vsem svetu.