Back to datasets
Dataset assetOpen Source CommunityData StandardizationHolidays
holiday-calendar
A standardized holiday dataset (JSON format) providing statutory holidays and make‑up workday arrangements for various regions.
Source
github
Created
Jan 16, 2025
Updated
Jan 17, 2025
Signals
456 views
Availability
Linked source ready
Overview
Dataset description and usage context
Dataset Overview
Dataset Name
holiday-calendar Holiday Calendar
Dataset Content
- Statutory Holidays
- Make‑up Workdays
Data Sources
- China (CN):
- Data derived from the State Council Office's holiday arrangement notices
- Updated annually, usually released at the end of the preceding year
- Japan (JP):
- Data sourced from the Cabinet Office "National Holidays"
- Updated annually, typically released a year in advance
Data Format
- Stored in JSON format
- Date Types:
public_holiday: statutory holidaytransfer_workday: make‑up workday
Data Example
{
"year": 2025,
"region": "CN",
"dates": [
{
"date": "2025-01-01",
"name": "New Years Day",
"name_cn": "元旦",
"name_en": "New Years Day",
"type": "public_holiday"
},
{
"date": "2025-01-26",
"name": "Spring Festival Workday",
"name_cn": "春节补班",
"name_en": "Spring Festival Workday",
"type": "transfer_workday"
}
]
}
Data Access
-
Via unpkg:
-
Via jsDelivr CDN:
https://gcore.jsdelivr.net/gh/cg-zhou/holiday-calendar@main/data/CN/2024.json
Usage
// Import package
const HolidayCalendar = require('holiday-calendar');
// Create instance
const calendar = new HolidayCalendar();
// Get date info for a specific day
calendar.getDateInfo('CN', '2024-01-01').then(dateInfo => {
if (dateInfo) {
console.log(`${dateInfo.date} is ${dateInfo.name_cn}`);
}
});
// Get all dates for a specific year
calendar.getDates('CN', 2025).then(dates => {
console.log('2025 dates:', dates);
});
// Use filters
calendar.getDates('CN', 2025, {
type: 'public_holiday', // Filter by type
startDate: '2025-01-01', // Filter by start date
endDate: '2025-12-31' // Filter by end date
}).then(dates => {
console.log('Filtered dates:', dates);
});
Related Links
- GitHub: cg-zhou/holiday-calendar
- Gitee: cg-zhou/holiday-calendar
- Contribution Guide: CONTRIBUTING.md
- Changelog: CHANGELOG.md
- MIT License: LICENSE
Need downstream help?
Pair the dataset with AI analysis and content workflows.
Once the source passes your review, move straight into summarization, transformation, report drafting, or presentation generation with the JuheAI toolchain.