Dorabot – Vietnam public holidays & business days

@dorabot-io/ngay-le

勤怠管理、給与計算、配送期限、書類の処理期限などに使えるベトナムの祝日・テト休暇ライブラリです。国際的な祝日ライブラリにはない、次の機能も備えています。

• 祝日が土曜日・日曜日と重なった場合の振替休日（2019年労働法第111条）。
• 内務省の年次通知に基づく勤務日の振替（例：2026年は1月2日が休みとなり、1月10日（土）に振替出勤）。
• 旧暦のテトを正確な日付で収録し、内務省が選択した日程を採用しています。
• ベトナム文化の日（11月24日） — 2026年から新たに有給休暇となる日（決議28/2026/QH16）。
• 2つのグループに対応：公務員（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年1月10日（土）に出勤）、旧暦のテト、2026年から新設されるベトナム文化の日（11月24日）を含む、2026～2040年のベトナムの祝日です。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 を作成してください。