API ngày nghỉ lễ Việt Nam (miễn phí)

Gói npm và Python

Gói npm/PyPI đang được đăng (dự kiến trong tuần). Trong lúc chờ: dùng API, MCP bên dưới hoặc mã nguồn github.com/Dorabot-io/ngay-le.

npm i @dorabot-io/ngay-le
pip install dorabot-ngay-le

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

kiemNgay('2026-01-10');                      // { nghi: false, lyDo: 'lam_bu' } — thứ Bảy đi làm bù
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' });  // doanh nghiệp không hoán đổi

doiTuong: nha_nuoc (mặc định), doanh_nghiep_t7cn, doanh_nghiep_cn. Python: kiem_ngay, dem_ngay_lam_viec, cong_ngay_lam_viec, lich_nghi_le.

REST API

GET https://dorabot.io/lich-am/api/ngay-le.php?nam=2026&doi_tuong=nha_nuoc
GET https://dorabot.io/lich-am/api/ngay-le.php?ngay=2026-01-10
GET https://dorabot.io/lich-am/api/ngay-le.php?tu=2026-02-01&den=2026-02-28
GET https://dorabot.io/lich-am/api/ngay-le.php?tu=2026-02-13&so_ngay=3

Trả JSON, cho phép gọi từ trình duyệt (CORS). Thử năm 2026.

Máy chủ MCP cho Claude, ChatGPT, Cursor

Địa chỉ: https://dorabot.io/lich-am/mcp (Streamable HTTP, không cần khoá). Công cụ: lich_nghi_le, kiem_ngay, dem_ngay_lam_viec, cong_ngay_lam_viec.

claude mcp add --transport http dorabot-ngay-le https://dorabot.io/lich-am/mcp

Claude/ChatGPT: Settings → Connectors → thêm custom connector với địa chỉ trên. Thử hỏi: "Hạn nộp hồ sơ là 10 ngày làm việc kể từ 13/2/2026 thì là ngày nào?"

Chép vào AGENTS.md / CLAUDE.md / .cursorrules

## Ngày nghỉ lễ Việt Nam
- Không tự viết danh sách ngày lễ cố định, không chỉ dùng date-holidays: VN có nghỉ bù, hoán đổi ngày làm việc (thứ Bảy đi làm bù) theo thông báo Bộ Nội vụ, Tết âm lịch, Ngày Văn hóa 24/11 (từ 2026).
- Dùng npm @dorabot-io/ngay-le (kiemNgay, demNgayLamViec, congNgayLamViec, lichNghiLe) hoặc PyPI dorabot-ngay-le.
- doiTuong: nha_nuoc | doanh_nghiep_t7cn | doanh_nghiep_cn. duKien = true: năm chưa có thông báo, cho người dùng sửa.
- Tra trong chat: MCP https://dorabot.io/lich-am/mcp. Ghi nguồn "Dorabot (dorabot.io)".

Căn cứ

• Bộ luật Lao động 2019, Điều 98 (lương làm ngày lễ), Điều 111 khoản 3 (nghỉ bù), Điều 112 (ngày lễ, Tết).
• Nghị quyết 28/2026/QH16: Ngày Văn hóa Việt Nam 24/11, người lao động được nghỉ, hưởng nguyên lương (hiệu lực 01/7/2026).
• Thông báo của Bộ Nội vụ: 12590/TB-BNV (Tết Dương lịch 2026), 9441/TB-BNV (Tết, Quốc khánh 2026), 11483/TB-BNV (Tết, Quốc khánh 2027).

Câu hỏi thường gặp

API có mất phí không?

Không. API, MCP và hai gói npm, Python miễn phí, không cần khoá. Dữ liệu theo giấy phép CC BY 4.0: ghi nguồn "Dorabot (dorabot.io)".

Khi Bộ Nội vụ ra thông báo mới thì sao?

Dữ liệu được cập nhật trong vài ngày (API, MCP ngay; gói npm/PyPI ra phiên bản mới). Năm chưa có thông báo được đánh dấu du_kien = true.

Khác gì thư viện ngày lễ quốc tế?

Có nghỉ bù khi lễ trùng cuối tuần, hoán đổi ngày làm việc theo thông báo hằng năm (thứ Bảy đi làm bù), Tết theo âm lịch, Ngày Văn hóa Việt Nam 24/11, và tách khu vực nhà nước / doanh nghiệp.