Tra cứu ngày lễ các nước online
Ngày nghỉ lễ, ngày lễ ngân hàng và ngày kỷ niệm của khoảng 200 quốc gia và bang, ngày lễ sắp tới, kiểm tra ngày lễ và đếm ngày làm việc.
Kết quả
Bấm “Chạy” để xem kết quả.
Truyền country (mã ISO, có thể kèm cấp bang/vùng: US-CA, DE-BY, GB-SCT) để nhận các ngày lễ trong year: ngày, ngày kết thúc với lễ kéo dài nhiều ngày, thời điểm bắt đầu và kết thúc theo múi giờ nước đó, tên bản địa, tên tiếng Anh, tên tiếng Việt khi dữ liệu có, loại (public, bank, school, optional, observance) và có phải ngày nghỉ bù hay không. Lọc bằng types=public, chọn ngôn ngữ tên với lang, xem danh sách bang bằng list=states; không truyền country thì API liệt kê mọi quốc gia được hỗ trợ.
Các chế độ khác: date=2026-12-25 cho biết một ngày là ngày lễ, cuối tuần hay ngày làm việc; next=5 trả về các ngày lễ sắp tới tính từ hôm nay (hoặc from); from + to đếm ngày làm việc (tính cả hai đầu) và liệt kê ngày lễ trong khoảng; add=10 + from cộng thêm số ngày làm việc. Cuối tuần theo CLDR của từng nước (thứ Sáu–thứ Bảy ở Ả Rập Xê Út, chỉ Chủ nhật ở Ấn Độ…) hoặc tự đặt weekend=6,0; ngày nghỉ là ngày lễ loại public và bank (đổi bằng business_types), lễ nửa ngày như chiều Đêm Giáng Sinh không tính là ngày nghỉ.
Quy tắc lấy từ dự án mở date-holidays (giấy phép CC BY-SA 4.0, mọi phản hồi đều kèm ghi công), gồm cả lịch Phục sinh, âm lịch, lịch Do Thái và lịch Hồi giáo, được cập nhật hằng tuần. Ngày theo lịch Hồi giáo là ngày tính toán, có thể lệch một ngày so với quan sát trăng thực tế. Với Việt Nam hãy dùng /v1/vn-holidays, theo Bộ luật Lao động và lịch nghỉ chính thức hằng năm.
Dùng trong code của bạn
curl "https://apibox.io.vn/v1/holidays?country=US&next=2&from=2026-11-11" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/holidays?country=US&next=2&from=2026-11-11', {
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/holidays?country=US&next=2&from=2026-11-11",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/holidays?country=US&next=2&from=2026-11-11');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Tài liệu API → Nhận API key miễn phí
Hỏi đáp
Dữ liệu lấy từ đâu?
Từ dự án date-holidays (github.com/commenthol/date-holidays), giấy phép CC BY-SA 4.0; cần giữ trường attribution khi công bố lại dữ liệu.
Có ngày lễ riêng của bang, vùng không?
Có, với các nước có dữ liệu cấp dưới: dùng country=US-CA hoặc state=CA; list=states cho biết các mã.
Còn Việt Nam thì sao?
Có dữ liệu Việt Nam, nhưng /v1/vn-holidays chính xác hơn: áp dụng Bộ luật Lao động và lịch nghỉ Tết, 2/9 chính thức.