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 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

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

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.

Explore AI studio