China Business Day & Lunar Calendar API

Accurately calculate business days in mainland China, including official weekend workdays created by holiday adjustments. Convert Gregorian and Chinese lunar dates, and enrich dates with festivals, zodiac signs, Ganzhi years, and solar terms.

Why this Actor

China's business calendar cannot be calculated with a normal Monday-to-Friday rule. Some Saturdays and Sundays are official workdays, while weekday holiday periods may span several days. This Actor returns both the result and the reason behind it.

Features

• Detect regular business days, weekends, public holidays, and makeup workdays.
• Add or subtract business days across official holiday adjustments.
• Inspect a date range and export one structured dataset item per day.
• Convert Gregorian dates to Chinese lunar dates.
• Convert Chinese lunar dates, including leap months, to Gregorian dates.
• Return Chinese festivals, zodiac signs, Ganzhi years, and solar terms.
• Mark years where an official holiday adjustment schedule is unavailable.

Input examples

Inspect dates

{
  "operation": "inspectDates",
  "dates": ["2026-01-04", "2026-02-17"],
  "includeCalendarDetails": true
}

Add business days

{
  "operation": "addBusinessDays",
  "dates": ["2025-12-31"],
  "businessDays": 1,
  "includeCalendarDetails": true
}

The result is 2026-01-04, an official Sunday makeup workday.

Inspect a date range

{
  "operation": "dateRange",
  "startDate": "2026-02-14",
  "endDate": "2026-02-23",
  "includeCalendarDetails": false
}

Lunar to Gregorian

{
  "operation": "lunarToSolar",
  "lunarDates": [
    {"year": 2026, "month": 1, "day": 1, "isLeapMonth": false}
  ]
}

Output

Each processed date becomes one dataset item. Important fields include:

• isBusinessDay: the final business-day decision.
• dayType: business_day, weekend, public_holiday, or makeup_workday.
• holidayName: the related official holiday when available.
• officialScheduleAvailable: whether the year has a published adjustment schedule in the Actor's pinned calendar data.
• scheduleWarning: present when only the normal weekday/weekend rule can be applied.
• lunar: optional Chinese lunar calendar details.

Accuracy and supported dates

Gregorian and lunar conversion supports years 1900 through 2100. Official holiday adjustment schedules are only available after the Chinese government publishes them and the Actor's pinned calendar data is updated. For years without a schedule, the Actor clearly marks the fallback and does not claim that the result is official.

This Actor provides calendar calculations, not legal, payroll, or financial advice. Organizations may apply their own working schedules.