{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"china-add-working-days"},"result":{"entity_type":"calculator","id":"china-add-working-days","calculator_id":"china-add-working-days","canonical_url":"https://tttkmbb.com/everyday/china-add-working-days","name":"Add Mainland China Working Days","title":"Add Mainland China Working Days – Deadlines with Official Holidays and 调休","category":"everyday","category_name":"Everyday Life","tool_name":"add_china_working_days","featured_mcp_tool":true,"description":"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.","agent_examples":["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."],"inputs":[{"name":"start_date","label":"Start date","type":"date","required":true,"description":"Starting mainland China civil date (YYYY-MM-DD), within 2024-2026.","example":"2026-09-24"},{"name":"working_days","label":"Working days","type":"integer","unit":"working days","required":true,"min":-750,"max":750,"description":"Signed number of official working days to add; the start date is excluded when non-zero. Negative values move backward.","example":5}],"outputs":[{"name":"start_date","label":"Start date","type":"date","decimals":4,"description":"Input start date."},{"name":"result_date","label":"Result date","type":"date","decimals":4,"description":"Date reached after adding the requested working days."},{"name":"result_weekday","label":"Result weekday","type":"string","decimals":4,"description":"Weekday of result_date."},{"name":"result_is_working_day","label":"Result is working day","type":"boolean","decimals":4,"description":"Whether result_date is an official working day."},{"name":"working_days_added","label":"Working days added","type":"integer","unit":"working days","decimals":4,"description":"Signed working-day offset requested."},{"name":"calendar_days_elapsed","label":"Calendar days elapsed","type":"integer","unit":"days","decimals":4,"description":"Signed Gregorian day difference result_date − start_date."},{"name":"non_working_days_skipped","label":"Non-working days skipped","type":"integer","unit":"days","decimals":4,"description":"Number of holiday/weekend dates crossed and not counted."},{"name":"adjusted_workdays_counted","label":"Adjusted workdays counted","type":"list","decimals":4,"description":"Weekend makeup workdays crossed and counted, with date and related holiday."},{"name":"source_document_ids","label":"Source documents","type":"string_list","decimals":4,"description":"Official notice identifiers used across the traversed years."},{"name":"dataset_version","label":"Dataset version","type":"string","decimals":4,"description":"Version of the source-traceable mainland China work-calendar package."},{"name":"coverage_start","label":"Coverage start","type":"date","decimals":4,"description":"First supported date in this package."},{"name":"coverage_end","label":"Coverage end","type":"date","decimals":4,"description":"Last supported date in this package."}],"input_schema":{"type":"object","properties":{"start_date":{"description":"Starting mainland China civil date (YYYY-MM-DD), within 2024-2026.","type":"string","format":"date","examples":["2026-09-24"]},"working_days":{"description":"Signed number of official working days to add; the start date is excluded when non-zero. Negative values move backward. Unit: working days.","type":"integer","minimum":-750,"maximum":750,"examples":[5],"x-unit":"working days"}},"additionalProperties":false,"required":["start_date","working_days"],"examples":[{"start_date":"2026-09-24","working_days":5},{"start_date":"2026-09-18","working_days":5}]},"output_schema":{"type":"object","properties":{"start_date":{"description":"Input start date.","type":"string","format":"date"},"result_date":{"description":"Date reached after adding the requested working days.","type":"string","format":"date"},"result_weekday":{"description":"Weekday of result_date.","type":"string"},"result_is_working_day":{"description":"Whether result_date is an official working day.","type":"boolean"},"working_days_added":{"description":"Signed working-day offset requested. Unit: working days.","type":"integer","x-unit":"working days"},"calendar_days_elapsed":{"description":"Signed Gregorian day difference result_date − start_date. Unit: days.","type":"integer","x-unit":"days"},"non_working_days_skipped":{"description":"Number of holiday/weekend dates crossed and not counted. Unit: days.","type":"integer","x-unit":"days"},"adjusted_workdays_counted":{"description":"Weekend makeup workdays crossed and counted, with date and related holiday.","type":"array"},"source_document_ids":{"description":"Official notice identifiers used across the traversed years.","type":"array","items":{"type":"string"}},"dataset_version":{"description":"Version of the source-traceable mainland China work-calendar package.","type":"string"},"coverage_start":{"description":"First supported date in this package.","type":"string","format":"date"},"coverage_end":{"description":"Last supported date in this package.","type":"string","format":"date"}}},"formula":"move one calendar day at a time in sign(working_days); decrement the remaining count only when is_working_day(date) is true","method":"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.","sources":[{"name":"国务院办公厅关于2024年部分节假日安排的通知 (国办发明电〔2023〕7号)","url":"https://www.gov.cn/zhengce/content/202310/content_6911527.htm","type":"government","retrieved_at":"2026-09-26","note":"Official national holiday-arrangement notice published 2023-10-25."},{"name":"国务院办公厅关于2025年部分节假日安排的通知 (国办发明电〔2024〕12号)","url":"https://www.gov.cn/zhengce/zhengceku/202411/content_6986383.htm","type":"government","retrieved_at":"2026-09-26","note":"Official national holiday-arrangement notice published 2024-11-12."},{"name":"国务院办公厅关于2026年部分节假日安排的通知 (国办发明电〔2025〕7号)","url":"https://www.gov.cn/zhengce/zhengceku/202511/content_7047091.htm","type":"government","retrieved_at":"2026-09-26","note":"Official national holiday-arrangement notice published 2025-11-04."}],"freshness":{"type":"static","max_age_seconds":null,"note":"Versioned official schedules for 2024-2026; calculations fail rather than extrapolate beyond published coverage."},"examples":[{"name":"Five working days across Mid-Autumn and National Day 2026","inputs":{"start_date":"2026-09-24","working_days":5},"expected":{"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},"url":"https://tttkmbb.com/api/v1/calculate/china-add-working-days?start_date=2026-09-24&working_days=5"},{"name":"Adjusted Sunday counts as a working day","inputs":{"start_date":"2026-09-18","working_days":5},"expected":{"result_date":"2026-09-24","adjusted_workdays_counted":[{"date":"2026-09-20","related_holiday":"National Day","related_holiday_zh":"国庆节"}]},"url":"https://tttkmbb.com/api/v1/calculate/china-add-working-days?start_date=2026-09-18&working_days=5"}],"faq":[{"q":"Does the start date count?","a":"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."},{"q":"What happens if the result would be in 2027?","a":"The calculator returns OUT_OF_RANGE instead of assuming a Monday-Friday calendar before the official 2027 holiday notice is published and incorporated."}],"tags":["add China business days","Chinese working day deadline","调休 deadline","China SLA date","China work calendar"],"related":[{"calculator_id":"china-working-day","reason":"Inspect the official status and source for one date."},{"calculator_id":"china-working-days-between","reason":"Count official working days in a range."},{"calculator_id":"add-days","reason":"Add plain calendar days without holiday rules."}],"links":{"html":"https://tttkmbb.com/everyday/china-add-working-days","markdown":"https://tttkmbb.com/everyday/china-add-working-days.md","json":"https://tttkmbb.com/everyday/china-add-working-days.json","api":"https://tttkmbb.com/api/v1/calculate/china-add-working-days","schema":"https://tttkmbb.com/api/v1/calculators/china-add-working-days","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-26"},"timestamp":"2026-09-27T00:08:45Z","next_actions":[{"tool":"add_china_working_days","calculator_id":"china-add-working-days","reason":"Run Add Mainland China Working Days with the inputs above."}],"links":{"mcp":"https://tttkmbb.com/mcp","a2a":"https://tttkmbb.com/a2a","openapi":"https://tttkmbb.com/openapi.json","llms_txt":"https://tttkmbb.com/llms.txt","feed":"https://tttkmbb.com/feed.xml","ard":"https://tttkmbb.com/.well-known/ard.json","ai_catalog":"https://tttkmbb.com/.well-known/ai-catalog.json","agent_card":"https://tttkmbb.com/.well-known/agent-card.json","mcp_server_card":"https://tttkmbb.com/mcp/server-card","mcp_server_card_legacy":"https://tttkmbb.com/.well-known/mcp-server-card.json","ai_plugin":"https://tttkmbb.com/.well-known/ai-plugin.json","agent_capabilities":"https://tttkmbb.com/agent-capabilities.json","docs":"https://tttkmbb.com/docs/index.md","privacy":"https://tttkmbb.com/docs/privacy","terms":"https://tttkmbb.com/docs/terms","support":"https://tttkmbb.com/docs/support","china_work_calendar_data":"https://tttkmbb.com/api/v1/data/china-work-calendar/2026","uk_bank_holidays_data":"https://tttkmbb.com/api/v1/data/uk-bank-holidays","iana_tzdb_data":"https://tttkmbb.com/api/v1/data/iana-tzdb","markdown":"https://tttkmbb.com/everyday/china-add-working-days.md"}}