Home › Everyday Life › Count Global Reference Working Days

Count Global Reference Working Days

Counts working and non-working dates in a 2026-2028 range using OpenWorkdays national-scope public-holiday data and country weekend rules.

Start dateFirst date in 2026-2028. End dateLast date in 2026-2028. CountryISO-style alpha-2 country code supported by the pinned OpenWorkdays reference snapshot. Include start date (optional)Whether start_date participates. Include end date (optional)Whether end_date participates.

When to use

You need a broad national-scope reference count and regional or employer semantics are not required.

Do not use when: The range needs a direct official authority, regional/local or employer calendar, or dates outside 2026-2028.

Example user requests

Count broad-reference working days in Australia from 2026-10-01 through 2026-10-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 source country weekends plus 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 \| AE \| AF \| AG \| AI \| AL \| AM \| AO \| AR \| AS \| AT \| AU \| AW \| AX \| AZ \| BA \| BB \| BD \| BE \| BF \| BG \| BH \| BI \| BJ \| BL \| BM \| BN \| BO \| BQ \| BR \| BS \| BT \| BW \| BY \| BZ \| CA \| CC \| CD \| CF \| CG \| CH \| CI \| CK \| CL \| CM \| CN \| CO \| CR \| CU \| CV \| CW \| CX \| CY \| CZ \| DE \| DJ \| DK \| DM \| DO \| DZ \| EC \| EE \| EG \| EH \| ER \| ES \| ET \| FI \| FJ \| FK \| FM \| FO \| FR \| GA \| GB \| GD \| GE \| GF \| GG \| GH \| GI \| GL \| GM \| GN \| GP \| GQ \| GR \| GS \| GT \| GU \| GW \| GY \| HK \| HN \| HR \| HT \| HU \| ID \| IE \| IL \| IM \| IN \| IQ \| IR \| IS \| IT \| JE \| JM \| JO \| JP \| KE \| KG \| KH \| KI \| KM \| KN \| KP \| KR \| KW \| KY \| KZ \| LA \| LB \| LC \| LI \| LK \| LR \| LS \| LT \| LU \| LV \| LY \| MA \| MC \| MD \| ME \| MF \| MG \| MH \| MK \| ML \| MM \| MN \| MO \| MP \| MQ \| MR \| MS \| MT \| MU \| MV \| MW \| MX \| MY \| MZ \| NA \| NC \| NE \| NF \| NG \| NI \| NL \| NO \| NP \| NR \| NU \| NZ \| OM \| PA \| PE \| PF \| PG \| PH \| PK \| PL \| PM \| PN \| PR \| PS \| PT \| PW \| PY \| QA \| RE \| RO \| RS \| RU \| RW \| SA \| SB \| SC \| SD \| SE \| SG \| SH \| SI \| SJ \| SK \| SL \| SM \| SN \| SO \| SR \| SS \| ST \| SV \| SX \| SY \| SZ \| TC \| TD \| TF \| TG \| TH \| TJ \| TK \| TL \| TM \| TN \| TO \| TR \| TT \| TV \| TW \| TZ \| UA \| UG \| UM \| US \| UY \| UZ \| VA \| VC \| VE \| VG \| VI \| VN \| VU \| WF \| WS \| XK \| YE \| YT \| ZA \| ZM \| ZW	yes	ISO-style alpha-2 country code supported by the pinned OpenWorkdays 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 public-holiday dates.
`calendar_days_counted`	integer	days	Total dates included.
`public_holidays_counted`	list		Source public-holiday events in the range.
`territory`	string		Normalized uppercase country code.
`territory_name`	string		Calcgrid display name; TW is displayed as 中国台湾省 while the machine code remains TW.
`source_territory_name`	string		Raw country name from the hash-pinned OpenWorkdays source catalogue.
`weekend_days`	string_list		Weekend convention supplied by the source country file.
`working_weekend_day`	boolean		True when the source explicitly marks a weekend date as an official working day.
`holiday_names`	string_list		Included national-scope public-holiday names on the date.
`holiday_observed`	boolean		True when an included event is marked observed by the source.
`holiday_estimated`	boolean		True when an included event is marked estimated by the source.
`holiday_policy`	string		National-scope events with source observed/estimated flags preserved.
`calendar_scope`	string		National reference plus country weekend and explicit working-weekend dates.
`calendar_profile`	string		global-working-day-reference.
`substitute_day_policy`	string		Source flags are preserved; no new substitute-day rule is inferred.
`source_quality`	string		Open derived reference, not a direct national authority feed.
`dataset_version`	string		Pinned OpenWorkdays snapshot version.
`coverage_start`	date		First supported date.
`coverage_end`	date		Last supported date.
`source_url`	string		Pinned OpenWorkdays source index.

Example

Australia October reference range: {"start_date":"2026-10-01","end_date":"2026-10-15","territory":"AU","include_start_date":true,"include_end_date":true} → {"working_days":11}

GET https://tttkmbb.com/api/v1/calculate/global-reference-working-days-between?start_date=2026-10-01&end_date=2026-10-15&territory=AU&include_start_date=true&include_end_date=true

Machine access

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

Sources

OpenWorkdays generated public-holiday and working-day data (open_derived_reference)

FAQ

Does this prove an employer's schedule?

This is a broad national-scope reference generated from an open rules-based library. It may omit regional, employer, bank, exchange, school or one-off authority closures, and future lunar/late-proclaimed dates can be marked estimated. 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 Working Day Reference — Inspect one date.
Add Global Reference Working Days — Add or subtract reference working days.