Home › Everyday Life › Count Global Public-Holiday Reference Working Days

Count Global Public-Holiday Reference Working Days

Counts working and non-working dates in a 2026-2028 range using CLDR weekends plus included nationwide OpenHolidays public events.

When to use

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.

Example user requests

Count reference working days in France from 2026-05-01 through 2026-05-15.

Formula

for each included date: working_days += reference status.is_working_day; non_working_days += not is_working_day

Normalize reversed endpoints, apply endpoint flags, and count the CLDR weekend plus included nationwide public-holiday events.

Inputs

Parameter	Type	Required	Description
`start_date`	date	yes	First date in 2026-2028.
`end_date`	date	yes	Last date in 2026-2028.
`territory`	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	yes	ISO-style alpha-2 country code supported by the pinned OpenHolidays public-holiday reference snapshot.
`include_start_date`	boolean	default true	Whether start_date participates.
`include_end_date`	boolean	default true	Whether end_date participates.

Outputs

Output	Type	Unit	Description
`normalized_start_date`	date		Earlier endpoint.
`normalized_end_date`	date		Later endpoint.
`working_days`	integer	working days	Reference working dates counted.
`non_working_days`	integer	days	Weekend and included public-holiday dates.
`calendar_days_counted`	integer	days	Total dates included.
`public_holidays_counted`	list		Included public-holiday events in the range.
`territory`	string		Normalized uppercase country code.
`territory_name`	string		English country name from the source catalogue.
`weekend_days`	string_list		CLDR weekend convention used as the base rule.
`holiday_names`	string_list		Included nationwide public-holiday names on the date.
`holiday_policy`	string		Nationwide public events only; regional and substitute-day rules are not inferred.
`calendar_scope`	string		Weekday plus nationwide public-holiday reference.
`calendar_profile`	string		global-public-holiday-reference.
`substitute_day_policy`	string		not_inferred.
`source_quality`	string		Open public-source aggregation, not a direct national authority feed.
`dataset_version`	string		Pinned OpenHolidays snapshot version.
`coverage_start`	date		First supported date.
`coverage_end`	date		Last supported date.
`source_commit`	string		Immutable source-data repository commit.

Example

France May reference range: {"start_date":"2026-05-01","end_date":"2026-05-15","territory":"FR","include_start_date":true,"include_end_date":true} → {"working_days":8}

GET 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

Machine access

API: GET https://tttkmbb.com/api/v1/calculate/global-public-holiday-working-days-between (query parameters) or POST with a JSON body {"inputs": {...}}
Schema: https://tttkmbb.com/api/v1/calculators/global-public-holiday-working-days-between · Markdown: https://tttkmbb.com/everyday/global-public-holiday-working-days-between.md · JSON definition: https://tttkmbb.com/everyday/global-public-holiday-working-days-between.json
MCP: server https://tttkmbb.com/mcp, tool count_global_public_holiday_working_days
OpenAPI operationId: count_global_public_holiday_working_days
Freshness: static. Authentication: none. Rate limit: fair use (see rate limits).

Sources

OpenHolidays API public-holiday data (open_data_aggregation)

FAQ

Does this prove an employer's working schedule?

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.

What happens outside 2026-2028?

The calculator fails closed with OUT_OF_RANGE.

Related calculators

Global Public-Holiday Working Day Reference — Inspect one date.
Add Global Public-Holiday Reference Working Days — Add or subtract reference working days.