{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"global-public-holiday-working-days-between"},"result":{"entity_type":"calculator","id":"global-public-holiday-working-days-between","calculator_id":"global-public-holiday-working-days-between","canonical_url":"https://tttkmbb.com/everyday/global-public-holiday-working-days-between","name":"Count Global Public-Holiday Reference Working Days","title":"Count Global Public-Holiday Reference Working Days – OpenHolidays","category":"everyday","category_name":"Everyday Life","tool_name":"count_global_public_holiday_working_days","featured_mcp_tool":true,"description":"Counts working and non-working dates in a 2026-2028 range using CLDR weekends plus included nationwide OpenHolidays public events.","use_when":"You need a source-labelled nationwide public-holiday reference count for a supported country and regional or substitute-day semantics are not required.","do_not_use_when":"The range needs a direct official authority, regional/local or employer calendar, substitute-day rules, or dates outside 2026-2028.","agent_examples":["Count reference working days in France from 2026-05-01 through 2026-05-15."],"inputs":[{"name":"start_date","label":"Start date","type":"date","required":true,"description":"First date in 2026-2028.","example":"2026-05-01"},{"name":"end_date","label":"End date","type":"date","required":true,"description":"Last date in 2026-2028.","example":"2026-05-15"},{"name":"territory","label":"Country","type":"enum","required":true,"values":[{"value":"AD","label":"AD"},{"value":"AL","label":"AL"},{"value":"AT","label":"AT"},{"value":"BE","label":"BE"},{"value":"BG","label":"BG"},{"value":"BY","label":"BY"},{"value":"CH","label":"CH"},{"value":"CZ","label":"CZ"},{"value":"DE","label":"DE"},{"value":"EE","label":"EE"},{"value":"ES","label":"ES"},{"value":"FR","label":"FR"},{"value":"HR","label":"HR"},{"value":"HU","label":"HU"},{"value":"IE","label":"IE"},{"value":"IT","label":"IT"},{"value":"LI","label":"LI"},{"value":"LT","label":"LT"},{"value":"LU","label":"LU"},{"value":"LV","label":"LV"},{"value":"MC","label":"MC"},{"value":"MD","label":"MD"},{"value":"MT","label":"MT"},{"value":"MX","label":"MX"},{"value":"NL","label":"NL"},{"value":"PL","label":"PL"},{"value":"PT","label":"PT"},{"value":"RO","label":"RO"},{"value":"RS","label":"RS"},{"value":"SE","label":"SE"},{"value":"SI","label":"SI"},{"value":"SK","label":"SK"},{"value":"SM","label":"SM"},{"value":"VA","label":"VA"},{"value":"ZA","label":"ZA"}],"description":"ISO-style alpha-2 country code supported by the pinned OpenHolidays public-holiday reference snapshot.","example":"DE"},{"name":"include_start_date","label":"Include start date","type":"boolean","required":false,"default":true,"description":"Whether start_date participates.","example":true},{"name":"include_end_date","label":"Include end date","type":"boolean","required":false,"default":true,"description":"Whether end_date participates.","example":true}],"outputs":[{"name":"normalized_start_date","label":"Normalized start","type":"date","decimals":4,"description":"Earlier endpoint."},{"name":"normalized_end_date","label":"Normalized end","type":"date","decimals":4,"description":"Later endpoint."},{"name":"working_days","label":"Working days","type":"integer","unit":"working days","decimals":4,"description":"Reference working dates counted."},{"name":"non_working_days","label":"Non-working days","type":"integer","unit":"days","decimals":4,"description":"Weekend and included public-holiday dates."},{"name":"calendar_days_counted","label":"Calendar days counted","type":"integer","unit":"days","decimals":4,"description":"Total dates included."},{"name":"public_holidays_counted","label":"Public holidays counted","type":"list","decimals":4,"description":"Included public-holiday events in the range."},{"name":"territory","label":"Country","type":"string","decimals":4,"description":"Normalized uppercase country code."},{"name":"territory_name","label":"Country name","type":"string","decimals":4,"description":"English country name from the source catalogue."},{"name":"weekend_days","label":"Weekend days","type":"string_list","decimals":4,"description":"CLDR weekend convention used as the base rule."},{"name":"holiday_names","label":"Public holidays","type":"string_list","decimals":4,"description":"Included nationwide public-holiday names on the date."},{"name":"holiday_policy","label":"Holiday policy","type":"string","decimals":4,"description":"Nationwide public events only; regional and substitute-day rules are not inferred."},{"name":"calendar_scope","label":"Calendar scope","type":"string","decimals":4,"description":"Weekday plus nationwide public-holiday reference."},{"name":"calendar_profile","label":"Calendar profile","type":"string","decimals":4,"description":"global-public-holiday-reference."},{"name":"substitute_day_policy","label":"Substitute-day policy","type":"string","decimals":4,"description":"not_inferred."},{"name":"source_quality","label":"Source quality","type":"string","decimals":4,"description":"Open public-source aggregation, not a direct national authority feed."},{"name":"dataset_version","label":"Dataset version","type":"string","decimals":4,"description":"Pinned OpenHolidays snapshot version."},{"name":"coverage_start","label":"Coverage start","type":"date","decimals":4,"description":"First supported date."},{"name":"coverage_end","label":"Coverage end","type":"date","decimals":4,"description":"Last supported date."},{"name":"source_commit","label":"Source commit","type":"string","decimals":4,"description":"Immutable source-data repository commit."}],"input_schema":{"type":"object","properties":{"start_date":{"description":"First date in 2026-2028.","type":"string","format":"date","examples":["2026-05-01"]},"end_date":{"description":"Last date in 2026-2028.","type":"string","format":"date","examples":["2026-05-15"]},"territory":{"description":"ISO-style alpha-2 country code supported by the pinned OpenHolidays public-holiday reference snapshot.","type":"string","enum":["AD","AL","AT","BE","BG","BY","CH","CZ","DE","EE","ES","FR","HR","HU","IE","IT","LI","LT","LU","LV","MC","MD","MT","MX","NL","PL","PT","RO","RS","SE","SI","SK","SM","VA","ZA"],"examples":["DE"],"pattern":"^[A-Z]{2}$","maxLength":2},"include_start_date":{"description":"Whether start_date participates.","type":"boolean","default":true,"examples":[true]},"include_end_date":{"description":"Whether end_date participates.","type":"boolean","default":true,"examples":[true]}},"additionalProperties":false,"required":["start_date","end_date","territory"],"examples":[{"start_date":"2026-05-01","end_date":"2026-05-15","territory":"FR","include_start_date":true,"include_end_date":true}]},"output_schema":{"type":"object","properties":{"normalized_start_date":{"description":"Earlier endpoint.","type":"string","format":"date"},"normalized_end_date":{"description":"Later endpoint.","type":"string","format":"date"},"working_days":{"description":"Reference working dates counted. Unit: working days.","type":"integer","x-unit":"working days"},"non_working_days":{"description":"Weekend and included public-holiday dates. Unit: days.","type":"integer","x-unit":"days"},"calendar_days_counted":{"description":"Total dates included. Unit: days.","type":"integer","x-unit":"days"},"public_holidays_counted":{"description":"Included public-holiday events in the range.","type":"array"},"territory":{"description":"Normalized uppercase country code.","type":"string"},"territory_name":{"description":"English country name from the source catalogue.","type":"string"},"weekend_days":{"description":"CLDR weekend convention used as the base rule.","type":"array","items":{"type":"string"}},"holiday_names":{"description":"Included nationwide public-holiday names on the date.","type":"array","items":{"type":"string"}},"holiday_policy":{"description":"Nationwide public events only; regional and substitute-day rules are not inferred.","type":"string"},"calendar_scope":{"description":"Weekday plus nationwide public-holiday reference.","type":"string"},"calendar_profile":{"description":"global-public-holiday-reference.","type":"string"},"substitute_day_policy":{"description":"not_inferred.","type":"string"},"source_quality":{"description":"Open public-source aggregation, not a direct national authority feed.","type":"string"},"dataset_version":{"description":"Pinned OpenHolidays snapshot version.","type":"string"},"coverage_start":{"description":"First supported date.","type":"string","format":"date"},"coverage_end":{"description":"Last supported date.","type":"string","format":"date"},"source_commit":{"description":"Immutable source-data repository commit.","type":"string"}}},"formula":"for each included date: working_days += reference status.is_working_day; non_working_days += not is_working_day","method":"Normalize reversed endpoints, apply endpoint flags, and count the CLDR weekend plus included nationwide public-holiday events.","sources":[{"name":"OpenHolidays API public-holiday data","url":"https://openholidaysapi.org/PublicHolidays","type":"open_data_aggregation","retrieved_at":"2026-09-29","licence":"ODbL-1.0","licence_url":"https://opendatacommons.org/licenses/odbl/1-0/","note":"Public-source aggregation; only nationwide Public events are included. Regional events, substitute-day inference and non-public observances are excluded."}],"freshness":{"type":"static","max_age_seconds":null,"note":"Pinned OpenHolidays 2026-2028 snapshot."},"examples":[{"name":"France May reference range","inputs":{"start_date":"2026-05-01","end_date":"2026-05-15","territory":"FR","include_start_date":true,"include_end_date":true},"expected":{"working_days":8},"url":"https://tttkmbb.com/api/v1/calculate/global-public-holiday-working-days-between?start_date=2026-05-01&end_date=2026-05-15&territory=FR&include_start_date=true&include_end_date=true"}],"faq":[{"q":"Does this prove an employer's working schedule?","a":"This reference package includes only nationwide public events from OpenHolidays for 2026-2028. It excludes regional/local holidays, substitute-day inference, employer, bank, exchange, school, religious and emergency closures. Verify material legal, payroll, banking or settlement decisions against the responsible authority."},{"q":"What happens outside 2026-2028?","a":"The calculator fails closed with OUT_OF_RANGE."}],"tags":["count global working days","public holiday reference","OpenHolidays range"],"related":[{"calculator_id":"global-public-holiday-working-day","reason":"Inspect one date."},{"calculator_id":"global-public-holiday-add-working-days","reason":"Add or subtract reference working days."}],"links":{"html":"https://tttkmbb.com/everyday/global-public-holiday-working-days-between","markdown":"https://tttkmbb.com/everyday/global-public-holiday-working-days-between.md","json":"https://tttkmbb.com/everyday/global-public-holiday-working-days-between.json","api":"https://tttkmbb.com/api/v1/calculate/global-public-holiday-working-days-between","schema":"https://tttkmbb.com/api/v1/calculators/global-public-holiday-working-days-between","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-27"},"timestamp":"2026-09-28T19:05:00Z","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","global_working_day_data":"https://tttkmbb.com/api/v1/data/global-working-day","global_public_holiday_data":"https://tttkmbb.com/api/v1/data/global-public-holidays","global_working_day_reference_data":"https://tttkmbb.com/api/v1/data/global-working-day-reference","working_day_catalog":"https://tttkmbb.com/api/v1/data/working-day-calendars","html":"https://tttkmbb.com/everyday/global-public-holiday-working-days-between","markdown":"https://tttkmbb.com/everyday/global-public-holiday-working-days-between.md","api":"https://tttkmbb.com/api/v1/calculate/global-public-holiday-working-days-between"}}