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

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

## Purpose

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

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

- What date is 5 China working days after 2026-09-24, accounting for Mid-Autumn and National Day?
- 从2026年9月18日起往后数5个中国工作日是哪天？
- Subtract 10 official mainland China business days from 2026-03-02.


## Input

| Parameter | Type | Unit | Required | Description |
| --- | --- | --- | --- | --- |
| `start_date` | date |  | required | Starting mainland China civil date (YYYY-MM-DD), within 2024-2026. |
| `working_days` | integer | working days | required | Signed number of official working days to add; the start date is excluded when non-zero. Negative values move backward. (min -750, max 750) |

## Output

| Field | Type | Unit | Description |
| --- | --- | --- | --- |
| `start_date` | date |  | Input start date. |
| `result_date` | date |  | Date reached after adding the requested working days. |
| `result_weekday` | string |  | Weekday of result_date. |
| `result_is_working_day` | boolean |  | Whether result_date is an official working day. |
| `working_days_added` | integer | working days | Signed working-day offset requested. |
| `calendar_days_elapsed` | integer | days | Signed Gregorian day difference result_date − start_date. |
| `non_working_days_skipped` | integer | days | Number of holiday/weekend dates crossed and not counted. |
| `adjusted_workdays_counted` | list |  | Weekend makeup workdays crossed and counted, with date and related holiday. |
| `source_document_ids` | string_list |  | Official notice identifiers used across the traversed years. |
| `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

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

## 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; calculations fail rather than extrapolate beyond published coverage.

## API

- `GET https://tttkmbb.com/api/v1/calculate/china-add-working-days?start_date=…&working_days=…`
- `POST https://tttkmbb.com/api/v1/calculate/china-add-working-days` 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-add-working-days · OpenAPI operationId `add_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: `add_china_working_days` (dedicated) or `run_calculator` with `{"calculator_id": "china-add-working-days", "inputs": {…}}`

## Example

- Five working days across Mid-Autumn and National Day 2026: inputs `{"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: inputs `{"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
```

## Limitations

You need calendar days, a sector-specific settlement calendar, a local holiday calendar, or a result outside the 2024-2026 coverage. 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. All values are computed from the formula above; no measurement or live data is involved.

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

- [Mainland China Working Day Checker](https://tttkmbb.com/everyday/china-working-day.md) — Inspect the official status and source for one date.
- [Mainland China Working Days Between Dates](https://tttkmbb.com/everyday/china-working-days-between.md) — Count official working days in a range.
- [Add or Subtract Days Calculator](https://tttkmbb.com/everyday/add-days.md) — Add plain calendar days without holiday rules.