Home › Everyday Life › Mainland China Working Days Between Dates

Mainland China Working Days Between Dates

Counts official mainland China working and non-working days in a date range using State Council holiday periods and weekend makeup workdays rather than a simple Monday-Friday rule.

When to use

You need the number of official mainland China working days in a 2024-2026 date range for an SLA, payroll, project or delivery estimate.

Do not use when: You need only elapsed calendar days, another jurisdiction, an industry-specific settlement calendar, or dates outside 2024-2026.

Example user requests

Formula

for each included date: working_days += is_working_day(date); non_working_days += not is_working_day(date)

The endpoints are included by default. If end_date is earlier, endpoints are swapped before applying include_start_date/include_end_date. Official exceptions override the ordinary weekday/weekend rule.

Inputs

ParameterTypeUnitRequiredDescription
start_datedateyesFirst date of the range (YYYY-MM-DD), within 2024-2026.
end_datedateyesLast date of the range (YYYY-MM-DD), within 2024-2026. Earlier dates are normalized and reported in a note.
include_start_datebooleandefault trueWhether start_date participates in the count.
include_end_datebooleandefault trueWhether end_date participates in the count.

Outputs

OutputTypeUnitDescription
normalized_start_datedateEarlier endpoint after normalization.
normalized_end_datedateLater endpoint after normalization.
working_daysintegerworking daysOfficial working dates in the selected inclusive/exclusive range.
non_working_daysintegerdaysOfficial holiday-period dates and regular weekends in the selected range.
calendar_days_countedintegerdaysTotal dates included after endpoint rules.
adjusted_workdays_countedlistWeekend makeup workdays included in the count.
holiday_dates_countedintegerdaysDates inside official holiday periods that were counted as non-working.
source_document_idsstring_listOfficial notice identifiers used across the range.
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

Range containing an adjusted Sunday and Mid-Autumn holiday: {"start_date":"2026-09-18","end_date":"2026-09-25","include_start_date":true,"include_end_date":true} → {"working_days":6,"non_working_days":2,"calendar_days_counted":8,"adjusted_workdays_counted":[{"date":"2026-09-20","related_holiday":"National Day","related_holiday_zh":"国庆节"}],"holiday_dates_counted":1}

GET https://tttkmbb.com/api/v1/calculate/china-working-days-between?start_date=2026-09-18&end_date=2026-09-25&include_start_date=true&include_end_date=true

Machine access

Sources

FAQ

Why is the result different from counting Monday-Friday?

Official holiday periods can include weekdays, while designated weekend makeup days can be working days. Both exceptions are applied before the normal weekday rule.

Are both endpoints included?

Yes by default. Set include_start_date or include_end_date to false when a contract or SLA excludes an endpoint.

Related calculators