Dorabot – Vietnam public holidays & business days

@dorabot-io/ngay-le

适用于考勤、薪资计算、交货期限、材料处理期限等应用的越南法定节假日和春节数据，包含国际节假日库缺少的内容：

• 补休日：法定节假日与周六或周日重合时（《2019 年劳动法》第 111 条）。
• 调换工作日：根据内务部每年发布的通知（例如，2026 年：1 月 2 日休息，1 月 10 日周六补班）。
• 农历春节：日期与农历一致，并采用内务部选定的方案。
• 越南文化日 11 月 24 日——自 2026 年起新增的带薪假日（第 28/2026/QH16 号决议）。
• 两类对象：干部、公务员（nha_nuoc）和企业（每周休息日为周六+周日或仅周日，不调换工作日）。

数据覆盖 2026–2040 年。已发布内务部通知的年份：采用通知中的安排（附文件编号和链接）。尚未发布通知的年份：按法律计算，并标记为 duKien: true。

npm i @dorabot-io/ngay-le

import { lichNghiLe, kiemNgay, demNgayLamViec, congNgayLamViec } from '@dorabot-io/ngay-le';

lichNghiLe(2026);
// [{ ten: 'Tết Dương lịch', tu: '2026-01-01', den: '2026-01-04', hoanDoi: [{ nghi: '2026-01-02', lamBu: '2026-01-10' }], nguon: {...} },
//  { ten: 'Tết Âm lịch (Tết Nguyên đán)', tu: '2026-02-14', den: '2026-02-22', soNgay: 9, ... }, ...]

kiemNgay('2026-01-10');   // { nghi: false, lyDo: 'lam_bu', ten: 'Làm bù cho ngày 2026-01-02 …' }   ← thứ Bảy vẫn đi làm
kiemNgay('2026-04-27');   // { nghi: true, lyDo: 'nghi_bu', ten: 'Nghỉ bù Giỗ Tổ Hùng Vương …' }
kiemNgay('2026-11-24');   // { nghi: true, lyDo: 'le', ten: 'Ngày Văn hóa Việt Nam (24/11)' }

demNgayLamViec('2026-02-01', '2026-02-28');           // 15 — công chuẩn tháng 2/2026
congNgayLamViec('2026-02-13', 3);                      // '2026-02-25' — hạn 3 ngày làm việc, qua Tết
kiemNgay('2026-01-02', { doiTuong: 'doanh_nghiep_cn' }); // { nghi: false } — doanh nghiệp không hoán đổi

doiTuong：nha_nuoc（默认）、doanh_nghiep_t7cn、doanh_nghiep_cn。企业可自行选择 5 天农历春节假期；此软件包采用政府部门的方案——如果公司选择不同方案，应用可进行调整。

还提供：Python pip install dorabot-ngay-le、REST GET https://dorabot.io/lich-am/api/ngay-le.php?nam=2026、MCP https://dorabot.io/lich-am/mcp（适用于 Claude、ChatGPT、Cursor）。农历、吉日、祈福文： https://dorabot.io/lich-am/

许可证：代码采用 MIT 许可证，数据采用 CC BY 4.0 许可证（注明来源“Dorabot (dorabot.io)”）。内务部发布的新通知会在几天内更新（升级版本）；如发现错误，请联系 [email protected]。 Dorabot (dorabot.io) 是越南的工具，与 dorabot.com 无关。

---

英文说明。 越南 2026–2040 年公共假日数据，包含补休日、政府公告的工作日调换（例如，2026 年 1 月 10 日周六补班）、农历春节，以及新增的越南文化日 11 月 24 日（自 2026 年起）。kiemNgay(date) = 是否为休息日，demNgayLamViec(from, to) = 工作日数量，congNgayLamViec(date, n) = 增加 n 个工作日。适用于公共部门和私营企业（每周休息日为周六+周日或仅周日）。代码采用 MIT 许可证，数据采用 CC BY 4.0 许可证。

本仓库内容

• js/ — npm 软件包 @dorabot-io/ngay-le
• python/ — PyPI 软件包 dorabot-ngay-le
• data/ngay-le.json — 共享数据（也可通过 API 获取）
• 如果发现内务部发布了尚未更新的通知，请提交 issue 并附上文件链接。