Ngày lễ & ngày làm việc API

Ngày nghỉ lễ Việt Nam theo năm (lịch chính thức và quy định Bộ luật Lao động), kiểm tra ngày làm việc, đếm ngày công và “N ngày làm việc sau”.

GEThttps://apibox.io.vn/v1/vn-holidays

Tiện ích lập trình▶ Dùng thử online

API ngày lễ biết các ngày nghỉ lễ của Việt Nam: Tết Dương lịch, Tết Nguyên đán (tính theo âm lịch), Giỗ Tổ Hùng Vương (10/3 âm lịch), 30/4 và 1/5, Quốc khánh 2/9 kèm ngày nghỉ thêm và, từ 2026, Ngày Văn hóa Việt Nam 24/11. Với các năm đã có thông báo lịch nghỉ (2024–2026 và Tết, 2/9 năm 2027), API dùng lịch chính thức, gồm cả cuối tuần trong đợt nghỉ và ngày thứ Bảy làm bù khi hoán đổi ngày; các năm khác tính theo Bộ luật Lao động: số ngày theo luật cộng ngày nghỉ bù cho ngày lễ trùng cuối tuần.

year=2026 liệt kê các kỳ nghỉ trong năm kèm số ngày làm việc. date= cho biết một ngày có phải ngày làm việc không và vì sao. from=&to= đếm số ngày làm việc, ngày cuối tuần và ngày lễ trong khoảng, còn from=&add=10 trả về ngày sau 10 ngày làm việc (hoặc trước đó với số âm), cách tính hạn xử lý, SLA thường dùng.

Lịch chính thức là lịch của cán bộ, công chức (nghỉ thứ Bảy, Chủ nhật). Doanh nghiệp phải cho nghỉ ít nhất số ngày luật định nhưng có thể chọn ngày khác cho Tết và 2/9; saturday_off=false tính cho tuần làm 6 ngày. Mỗi kỳ nghỉ có ghi official (chính thức) hay estimated (ước tính).

Tham số

Tên	Vị trí	Kiểu	Bắt buộc	Mặc định
`year`	query	number	không		Liệt kê ngày lễ của một năm (2021–2199). Mặc định: năm nay.
`date`	query	string	không		Kiểm tra một ngày (`YYYY-MM-DD`).
`from`	query	string	không		Ngày bắt đầu khoảng, hoặc ngày gốc khi dùng `add`.
`to`	query	string	không		Ngày kết thúc (tính cả ngày này): đếm ngày làm việc.
`add`	query	number	không		Số ngày làm việc cần cộng (âm: lùi lại).
`saturday_off`	query	boolean	không	`true`	`false`: tuần làm 6 ngày (chỉ nghỉ Chủ nhật).

Ví dụ

curl "https://apibox.io.vn/v1/vn-holidays?from=2026-02-12&add=3" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-holidays?from=2026-02-12&add=3', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
  },
});
const data = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://apibox.io.vn/v1/vn-holidays?from=2026-02-12&add=3",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-holidays?from=2026-02-12&add=3');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "from": "2026-02-12",
  "add_workdays": 3,
  "saturday_off": true,
  "result": {
    "date": "2026-02-24",
    "weekday": "Tuesday",
    "weekday_vi": "Thứ Ba",
    "is_workday": true,
    "is_weekend": false,
    "is_make_up_workday": false,
    "holiday": null
  },
  "calendar_days": 12,
  "holidays_skipped": [
    "Lunar New Year (Tết)"
  ],
  "note": "Schedules marked \"official\" are those announced for civil servants…"
}

Ứng dụng

Tính ngày giao hàng, SLA bỏ qua ngày lễ Việt Nam
Hệ thống nghỉ phép, chấm công: đếm ngày công trong tháng
Hiển thị các kỳ nghỉ sắp tới trong app nhân sự, đặt lịch
Lên kế hoạch phát hành, chiến dịch quanh Tết

Hỏi đáp

Tết được nghỉ mấy ngày?

Luật quy định 5 ngày. Thực tế Chính phủ hoán đổi ngày để cả đợt, tính cả cuối tuần, kéo dài 7–9 ngày (14–22/2/2026 với cán bộ, công chức). API trả về lịch chính thức khi đã có thông báo.

Ngày 24/11 có được nghỉ không?

Có, từ năm 2026: Ngày Văn hóa Việt Nam là ngày nghỉ hưởng lương theo Nghị quyết 28/2026/QH16 (hiệu lực 1/7/2026).

Ngày lễ trùng cuối tuần thì sao?

Người lao động được nghỉ bù vào ngày làm việc kế tiếp (Bộ luật Lao động, Điều 111). Lịch ước tính áp dụng quy tắc này.

Ngày lễ & ngày làm việc API

Tham số

Ví dụ

Kết quả trả về

Ứng dụng

Hỏi đáp

API liên quan

Tạo UUID

Phân tích biểu thức cron

Giờ & múi giờ