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 holiday
  • transfer_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:

  https://unpkg.com/holiday-calendar/data/CN/2024.json

• 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