Phương pháp luận về Lịch

1. Công cụ đa lịch quyết định

Các ngày lễ công cộng trên toàn thế giới tuân theo nhiều hệ thống toán học và văn hóa đa dạng. Đường ống của chúng tôi lập mô hình cho bốn cơ chế lịch chính:

Ngày Gregory cố định: Các ngày lễ quốc gia và kỷ niệm lịch sử rơi vào các ngày cố định trong lịch (ví dụ: ngày 4 tháng 7, ngày 1 tháng 1).

Tính toán thiên văn & phân điểm: Điểm chí, điểm phân và các tiết khí được tính toán bằng tọa độ thiên thể chính xác.

Lịch âm & Âm dương: Lịch Hồi giáo Hijri, Tết Nguyên đán của Trung Quốc, Diwali và các dịp lễ Phật giáo được tính toán thông qua các mô hình hiển thị pha mặt trăng tiêu chuẩn và được xác minh dựa trên các tuyên bố của cơ quan tôn giáo quốc gia.

Thuật toán Computus: Các chu kỳ Lễ Phục sinh của phương Tây (Gregory) và Chính thống giáo phương Đông (Julian) cùng các ngày lễ di động phụ thuộc (Thứ Sáu Tuần Thánh, Lễ Thăng Thiên, Thứ Hai Trắng, Lễ Mình Máu Thánh).

2. Luật định & Sắc lệnh chính thức

Các mô hình toán học cung cấp ngày tháng thô, nhưng luật pháp quy định thời gian nghỉ ngơi hợp pháp. Chúng tôi đối chiếu từng sự kiện được tính toán với các văn bản pháp lý chính: bộ luật lao động quốc gia, đạo luật của nghị viện, công báo nhà nước chính thức và các sắc lệnh hành pháp.

Trong trường hợp các thư viện tiêu chuẩn bỏ sót các cải cách theo luật định hoặc sử dụng các quy tắc lỗi thời, cơ quan đăng ký ghi đè thủ công của chúng tôi (data/holiday-overrides.ts) sẽ thi hành các bản chỉnh sửa theo luật định đã được xác minh.

3. Ngày nghỉ bù & Mô hình chuyển ngày cuối tuần

Một trong những khía cạnh quan trọng nhất của việc lập kế hoạch nghỉ lễ là xác định điều gì xảy ra khi một ngày lễ theo luật định trùng với cuối tuần.

Công cụ của chúng tôi mã hóa một cách có hệ thống các quy tắc bồi thường quốc gia: tự động chuyển sang thứ Hai tiếp theo (ví dụ: Vương quốc Anh, Úc, Mỹ), chuyển sang thứ Sáu trước đó hoặc các quy tắc ngày làm việc tiếp theo có sẵn (ví dụ: Albania, Nam Phi), đảm bảo tính toán chính xác số ngày làm việc.

4. Kiểm toán lập pháp liên tục & Kiểm thử hồi quy

Mỗi lịch quốc gia đều phải trải qua quá trình xác thực ảnh chụp nhanh tự động (npm run holidays:validate:snapshots) để ngăn chặn hồi quy, trong khi đường ống theo dõi liên tục của chúng tôi theo dõi các luật mới ban hành, ngày nghỉ ngân hàng một lần và các sắc lệnh của hoàng gia hoặc tổng thống trên toàn thế giới.