Home › Everyday Life › Add Mainland China Working Days

Add Mainland China Working Days

Adds or subtracts official mainland China working days, skipping holiday periods and ordinary weekends while counting State Council-designated weekend makeup workdays.

When to use

You need a deadline or settlement date a stated number of mainland China national working days before or after a 2024-2026 date.

Do not use when: You need calendar days, a sector-specific settlement calendar, a local holiday calendar, or a result outside the 2024-2026 coverage.

Example user requests

Formula

move one calendar day at a time in sign(working_days); decrement the remaining count only when is_working_day(date) is true

The start date is excluded for non-zero offsets. Official holiday-period dates and ordinary weekends are skipped; official weekend makeup workdays count. A zero offset returns the start date unchanged.

Inputs

ParameterTypeUnitRequiredDescription
start_datedateyesStarting mainland China civil date (YYYY-MM-DD), within 2024-2026.
working_daysintegerworking daysyesSigned number of official working days to add; the start date is excluded when non-zero. Negative values move backward. Range: ≥ -750, ≤ 750

Outputs

OutputTypeUnitDescription
start_datedateInput start date.
result_datedateDate reached after adding the requested working days.
result_weekdaystringWeekday of result_date.
result_is_working_daybooleanWhether result_date is an official working day.
working_days_addedintegerworking daysSigned working-day offset requested.
calendar_days_elapsedintegerdaysSigned Gregorian day difference result_date − start_date.
non_working_days_skippedintegerdaysNumber of holiday/weekend dates crossed and not counted.
adjusted_workdays_countedlistWeekend makeup workdays crossed and counted, with date and related holiday.
source_document_idsstring_listOfficial notice identifiers used across the traversed years.
dataset_versionstringVersion of the source-traceable mainland China work-calendar package.
coverage_startdateFirst supported date in this package.
coverage_enddateLast supported date in this package.

Example

Five working days across Mid-Autumn and National Day 2026: {"start_date":"2026-09-24","working_days":5} → {"result_date":"2026-10-09","result_weekday":"Friday","result_is_working_day":true,"working_days_added":5,"calendar_days_elapsed":15,"non_working_days_skipped":10}

Adjusted Sunday counts as a working day: {"start_date":"2026-09-18","working_days":5} → {"result_date":"2026-09-24","adjusted_workdays_counted":[{"date":"2026-09-20","related_holiday":"National Day","related_holiday_zh":"国庆节"}]}

GET https://tttkmbb.com/api/v1/calculate/china-add-working-days?start_date=2026-09-24&working_days=5

Machine access

Sources

FAQ

Does the start date count?

No for non-zero offsets: +1 means the first official working day after start_date and −1 means the first before it. A zero offset returns start_date unchanged.

What happens if the result would be in 2027?

The calculator returns OUT_OF_RANGE instead of assuming a Monday-Friday calendar before the official 2027 holiday notice is published and incorporated.

Related calculators