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

- Calculator id: `china-working-days-between` · Category: Everyday Life (`everyday`) · Tool name: `count_china_working_days`
- Canonical page: https://tttkmbb.com/everyday/china-working-days-between · This document: https://tttkmbb.com/everyday/china-working-days-between.md · JSON definition: https://tttkmbb.com/everyday/china-working-days-between.json

## Purpose

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.

**Use when:** 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

- How many official China working days are there from 2026-09-18 through 2026-09-25, inclusive?
- 计算2026年国庆节前后这段日期中实际需要上班的天数，要包含调休周末。
- Count mainland China business days between 2025-01-24 and 2025-02-10.


## Input

| Parameter | Type | Unit | Required | Description |
| --- | --- | --- | --- | --- |
| `start_date` | date |  | required | First date of the range (YYYY-MM-DD), within 2024-2026. |
| `end_date` | date |  | required | Last date of the range (YYYY-MM-DD), within 2024-2026. Earlier dates are normalized and reported in a note. |
| `include_start_date` | boolean |  | optional, default true | Whether start_date participates in the count. |
| `include_end_date` | boolean |  | optional, default true | Whether end_date participates in the count. |

## Output

| Field | Type | Unit | Description |
| --- | --- | --- | --- |
| `normalized_start_date` | date |  | Earlier endpoint after normalization. |
| `normalized_end_date` | date |  | Later endpoint after normalization. |
| `working_days` | integer | working days | Official working dates in the selected inclusive/exclusive range. |
| `non_working_days` | integer | days | Official holiday-period dates and regular weekends in the selected range. |
| `calendar_days_counted` | integer | days | Total dates included after endpoint rules. |
| `adjusted_workdays_counted` | list |  | Weekend makeup workdays included in the count. |
| `holiday_dates_counted` | integer | days | Dates inside official holiday periods that were counted as non-working. |
| `source_document_ids` | string_list |  | Official notice identifiers used across the range. |
| `dataset_version` | string |  | Version of the source-traceable mainland China work-calendar package. |
| `coverage_start` | date |  | First supported date in this package. |
| `coverage_end` | date |  | Last supported date in this package. |

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

## Data Sources

- 国务院办公厅关于2024年部分节假日安排的通知 (国办发明电〔2023〕7号) — https://www.gov.cn/zhengce/content/202310/content_6911527.htm (government, retrieved 2026-09-26)
- 国务院办公厅关于2025年部分节假日安排的通知 (国办发明电〔2024〕12号) — https://www.gov.cn/zhengce/zhengceku/202411/content_6986383.htm (government, retrieved 2026-09-26)
- 国务院办公厅关于2026年部分节假日安排的通知 (国办发明电〔2025〕7号) — https://www.gov.cn/zhengce/zhengceku/202511/content_7047091.htm (government, retrieved 2026-09-26)

Data freshness: `static`. Versioned official schedules for 2024-2026; no extrapolation beyond published coverage.

## API

- `GET https://tttkmbb.com/api/v1/calculate/china-working-days-between?start_date=…&end_date=…`
- `POST https://tttkmbb.com/api/v1/calculate/china-working-days-between` with JSON body `{"inputs": {…}}`
- Response: unified envelope (`success`, `request`, `result.values`, `result.units`, `sources`, `freshness`, `timestamp`, `next_actions`, `links`); see https://tttkmbb.com/docs/response-format.md
- Schema: https://tttkmbb.com/api/v1/calculators/china-working-days-between · OpenAPI operationId `count_china_working_days` in https://tttkmbb.com/openapi.json
- Authentication: none. Rate limit: fair use, see https://tttkmbb.com/docs/rate-limits.md.

## MCP

- Server: `https://tttkmbb.com/mcp` (Streamable HTTP, JSON-RPC 2.0, no auth)
- Tool: `count_china_working_days` (dedicated) or `run_calculator` with `{"calculator_id": "china-working-days-between", "inputs": {…}}`

## Example

- Range containing an adjusted Sunday and Mid-Autumn holiday: inputs `{"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
```

## Limitations

You need only elapsed calendar days, another jurisdiction, an industry-specific settlement calendar, or dates outside 2024-2026. 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. All values are computed from the formula above; no measurement or live data is involved.

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

- [Mainland China Working Day Checker](https://tttkmbb.com/everyday/china-working-day.md) — Inspect one date and its official source.
- [Add Mainland China Working Days](https://tttkmbb.com/everyday/china-add-working-days.md) — Find a deadline after a working-day offset.
- [Date Difference Calculator](https://tttkmbb.com/everyday/date-difference.md) — Calendar-day and simple Monday-Friday difference.