# Mainland China Working Day Checker

> Checks whether a date is an official national working day in mainland China, including weekend makeup workdays (调休上班) and multi-day holiday periods from State Council notices.

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

## Purpose

Checks whether a date is an official national working day in mainland China, including weekend makeup workdays (调休上班) and multi-day holiday periods from State Council notices.

**Use when:** You need to know whether a specific 2024-2026 date is a working day in mainland China, especially around Spring Festival, National Day or another adjusted holiday.

**Do not use when:** You need a Hong Kong, Macao, Taiwan, local minority, school, employer, bank-settlement or stock-exchange calendar, or a year outside 2024-2026.

## Example user requests

- Is Sunday 2026-01-04 an official working day in mainland China?
- 2026年9月20日是休息日还是调休上班？
- Will mainland China offices normally work on 2026-02-18?


## Input

| Parameter | Type | Unit | Required | Description |
| --- | --- | --- | --- | --- |
| `date` | date |  | required | Mainland China civil date (YYYY-MM-DD), within 2024-2026. |

## Output

| Field | Type | Unit | Description |
| --- | --- | --- | --- |
| `date` | date |  | The checked civil date. |
| `weekday` | string |  | Gregorian weekday. |
| `is_working_day` | boolean |  | True for a regular weekday or official adjusted weekend working day. |
| `day_type` | string |  | adjusted_workday, official_holiday_period, regular_weekday or regular_weekend. |
| `holiday_name` | string |  | English holiday name when the date belongs to or compensates for a holiday; otherwise empty. |
| `holiday_name_zh` | string |  | Chinese holiday name when applicable; otherwise empty. |
| `status_basis` | string |  | Why the date is treated as working or non-working. |
| `jurisdiction` | string |  | Calendar scope. |
| `source_document_id` | string |  | Official State Council notice identifier for the date's year. |
| `source_published_at` | date |  | Publication date of the official annual notice. |
| `source_url` | string |  | Official Chinese Government source URL. |
| `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

`adjusted weekend workday override → working; else official holiday-period override → non-working; else Monday-Friday → working; Saturday-Sunday → non-working`

The annual State Council notice is transcribed into holiday periods and adjusted weekend workdays. Explicit exceptions are applied before the normal Monday-Friday rule. Every result returns the notice identifier, source URL and versioned dataset coverage.

## 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. Future years are added only after the State Council publishes the annual notice.

## API

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

## Example

- Sunday makeup workday after 2026 New Year: inputs `{"date":"2026-01-04"}` → `{"weekday":"Sunday","is_working_day":true,"day_type":"adjusted_workday","holiday_name_zh":"元旦","source_document_id":"国办发明电〔2025〕7号"}`
- Spring Festival holiday period: inputs `{"date":"2026-02-18"}` → `{"is_working_day":false,"day_type":"official_holiday_period","holiday_name":"Spring Festival"}`

```
GET https://tttkmbb.com/api/v1/calculate/china-working-day?date=2026-01-04
```

## Limitations

You need a Hong Kong, Macao, Taiwan, local minority, school, employer, bank-settlement or stock-exchange calendar, or a year outside 2024-2026. The annual State Council notice is transcribed into holiday periods and adjusted weekend workdays. Explicit exceptions are applied before the normal Monday-Friday rule. Every result returns the notice identifier, source URL and versioned dataset coverage. All values are computed from the formula above; no measurement or live data is involved.

## FAQ

**Why can Sunday be a working day?**

China's annual holiday arrangement can exchange weekend rest days for longer holiday periods. The official notice explicitly lists those makeup working days (调休上班).

**Is this a stock-exchange or bank-settlement calendar?**

No. It is the national public working-day schedule. Exchanges, banks, schools, employers and local jurisdictions can use different calendars.

## Related

- [Add Mainland China Working Days](https://tttkmbb.com/everyday/china-add-working-days.md) — Add or subtract official mainland China working days.
- [Mainland China Working Days Between Dates](https://tttkmbb.com/everyday/china-working-days-between.md) — Count official working days in a date range.
- [Date Difference Calculator](https://tttkmbb.com/everyday/date-difference.md) — Calendar-day difference without public-holiday rules.