Nasza metodologia kalendarza

1. Deterministyczny silnik wielokalendarzowy

Święta państwowe na całym świecie podlegają różnorodnym systemom matematycznym i kulturowym. Nasz proces modeluje cztery główne mechanizmy kalendarzowe:

Stałe daty gregoriańskie: Dni narodowe i rocznice historyczne przypadające na stałe daty w kalendarzu (np. 4 lipca, 1 stycznia).

Obliczenia astronomiczne i równonocne: Przesilenia, równonoce i terminy słoneczne obliczane przy użyciu precyzyjnych współrzędnych ciał niebieskich.

Kalendarze księżycowe i lunisolarne: Islamski kalendarz Hidżry, chiński Nowy Rok Księżycowy, Diwali i uroczystości buddyjskie obliczane za pomocą standardowych modeli widoczności faz księżyca i weryfikowane z proklamacjami krajowych władz religijnych.

Algorytmy Computus: Zachodnie (gregoriańskie) i wschodnio-prawosławne (juliańskie) cykle wielkanocne oraz powiązane z nimi święta ruchome (Wielki Piątek, Wniebowstąpienie, Poniedziałek Zielonych Świątek, Boże Ciało).

2. Ustawodawstwo i oficjalne dekrety

Modele matematyczne dostarczają surowych dat, jednak prawa ustawowe dyktują prawne dni wolne. Każde obliczone wystąpienie krzyżujemy z podstawowymi instrumentami prawnymi: krajowymi kodeksami pracy, ustawami parlamentarnymi, oficjalnymi dziennikami urzędowymi i zarządzeniami wykonawczymi.

Tam, gdzie standardowe biblioteki pomijają reformy ustawowe lub stosują przestarzałe zasady, nasz rejestr ręcznych nadpiszeń (data/holiday-overrides.ts) wymusza zweryfikowane korekty ustawowe.

3. Dni zamienne i modelowanie przesunięć weekendowych

Jednym z najważniejszych aspektów planowania urlopów jest ustalenie, co się stanie, gdy święto ustawowe przypada w weekend.

Nasz silnik systematycznie koduje narodowe zasady kompensacyjne: automatyczne przesunięcia na poniedziałek (np. Wielka Brytania, Australia, USA), przesunięcia na poprzedzający piątek lub zasady najbliższego dostępnego dnia roboczego (np. Albania, RPA), co zapewnia dokładne liczenie dni roboczych.

4. Ciągłe audyty legislacyjne i testy regresji

Kalendarz każdego kraju podlega zautomatyzowanej walidacji migawki (npm run holidays:validate:snapshots), aby zapobiec regresji, podczas gdy nasz potok ciągłego monitorowania śledzi nowo uchwalone prawa, jednorazowe dni wolne dla banków oraz dekrety królewskie lub prezydenckie na całym świecie.