{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"china-working-days-between"},"result":{"entity_type":"calculator","id":"china-working-days-between","calculator_id":"china-working-days-between","canonical_url":"https://tttkmbb.com/everyday/china-working-days-between","name":"Mainland China Working Days Between Dates","title":"Mainland China Working Days Between Dates – Count Official Holidays and 调休 Correctly","category":"everyday","category_name":"Everyday Life","tool_name":"count_china_working_days","featured_mcp_tool":true,"description":"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.","agent_examples":["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."],"inputs":[{"name":"start_date","label":"Start date","type":"date","required":true,"description":"First date of the range (YYYY-MM-DD), within 2024-2026.","example":"2026-09-18"},{"name":"end_date","label":"End date","type":"date","required":true,"description":"Last date of the range (YYYY-MM-DD), within 2024-2026. Earlier dates are normalized and reported in a note.","example":"2026-09-25"},{"name":"include_start_date","label":"Include start date","type":"boolean","required":false,"default":true,"description":"Whether start_date participates in the count.","example":true},{"name":"include_end_date","label":"Include end date","type":"boolean","required":false,"default":true,"description":"Whether end_date participates in the count.","example":true}],"outputs":[{"name":"normalized_start_date","label":"Normalized start","type":"date","decimals":4,"description":"Earlier endpoint after normalization."},{"name":"normalized_end_date","label":"Normalized end","type":"date","decimals":4,"description":"Later endpoint after normalization."},{"name":"working_days","label":"Working days","type":"integer","unit":"working days","decimals":4,"description":"Official working dates in the selected inclusive/exclusive range."},{"name":"non_working_days","label":"Non-working days","type":"integer","unit":"days","decimals":4,"description":"Official holiday-period dates and regular weekends in the selected range."},{"name":"calendar_days_counted","label":"Calendar days counted","type":"integer","unit":"days","decimals":4,"description":"Total dates included after endpoint rules."},{"name":"adjusted_workdays_counted","label":"Adjusted workdays counted","type":"list","decimals":4,"description":"Weekend makeup workdays included in the count."},{"name":"holiday_dates_counted","label":"Holiday dates counted","type":"integer","unit":"days","decimals":4,"description":"Dates inside official holiday periods that were counted as non-working."},{"name":"source_document_ids","label":"Source documents","type":"string_list","decimals":4,"description":"Official notice identifiers used across the range."},{"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":"First date of the range (YYYY-MM-DD), within 2024-2026.","type":"string","format":"date","examples":["2026-09-18"]},"end_date":{"description":"Last date of the range (YYYY-MM-DD), within 2024-2026. Earlier dates are normalized and reported in a note.","type":"string","format":"date","examples":["2026-09-25"]},"include_start_date":{"description":"Whether start_date participates in the count.","type":"boolean","default":true,"examples":[true]},"include_end_date":{"description":"Whether end_date participates in the count.","type":"boolean","default":true,"examples":[true]}},"additionalProperties":false,"required":["start_date","end_date"],"examples":[{"start_date":"2026-09-18","end_date":"2026-09-25","include_start_date":true,"include_end_date":true}]},"output_schema":{"type":"object","properties":{"normalized_start_date":{"description":"Earlier endpoint after normalization.","type":"string","format":"date"},"normalized_end_date":{"description":"Later endpoint after normalization.","type":"string","format":"date"},"working_days":{"description":"Official working dates in the selected inclusive/exclusive range. Unit: working days.","type":"integer","x-unit":"working days"},"non_working_days":{"description":"Official holiday-period dates and regular weekends in the selected range. Unit: days.","type":"integer","x-unit":"days"},"calendar_days_counted":{"description":"Total dates included after endpoint rules. Unit: days.","type":"integer","x-unit":"days"},"adjusted_workdays_counted":{"description":"Weekend makeup workdays included in the count.","type":"array"},"holiday_dates_counted":{"description":"Dates inside official holiday periods that were counted as non-working. Unit: days.","type":"integer","x-unit":"days"},"source_document_ids":{"description":"Official notice identifiers used across the range.","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":"for each included date: working_days += is_working_day(date); non_working_days += not is_working_day(date)","method":"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.","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; no extrapolation beyond published coverage."},"examples":[{"name":"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},"expected":{"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},"url":"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"}],"faq":[{"q":"Why is the result different from counting Monday-Friday?","a":"Official holiday periods can include weekdays, while designated weekend makeup days can be working days. Both exceptions are applied before the normal weekday rule."},{"q":"Are both endpoints included?","a":"Yes by default. Set include_start_date or include_end_date to false when a contract or SLA excludes an endpoint."}],"tags":["count China business days","China working days between dates","调休 workday count","China SLA","China holiday calendar"],"related":[{"calculator_id":"china-working-day","reason":"Inspect one date and its official source."},{"calculator_id":"china-add-working-days","reason":"Find a deadline after a working-day offset."},{"calculator_id":"date-difference","reason":"Calendar-day and simple Monday-Friday difference."}],"links":{"html":"https://tttkmbb.com/everyday/china-working-days-between","markdown":"https://tttkmbb.com/everyday/china-working-days-between.md","json":"https://tttkmbb.com/everyday/china-working-days-between.json","api":"https://tttkmbb.com/api/v1/calculate/china-working-days-between","schema":"https://tttkmbb.com/api/v1/calculators/china-working-days-between","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-26"},"timestamp":"2026-09-27T00:04:30Z","next_actions":[{"tool":"count_china_working_days","calculator_id":"china-working-days-between","reason":"Run Mainland China Working Days Between Dates 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-working-days-between.md"}}