# 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.

- Calculator id: `global-reference-working-days-between` · Category: Everyday Life (`everyday`) · Tool name: `count_global_reference_working_days`
- Canonical page: https://tttkmbb.com/everyday/global-reference-working-days-between · This document: https://tttkmbb.com/everyday/global-reference-working-days-between.md · JSON definition: https://tttkmbb.com/everyday/global-reference-working-days-between.json

## Purpose

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

**Use when:** 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.


## Input

| Parameter | Type | Unit | Required | Description |
| --- | --- | --- | --- | --- |
| `start_date` | date |  | required | First date in 2026-2028. |
| `end_date` | date |  | required | 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 |  | required | ISO-style alpha-2 country code supported by the pinned OpenWorkdays reference snapshot. |
| `include_start_date` | boolean |  | optional, default true | Whether start_date participates. |
| `include_end_date` | boolean |  | optional, default true | Whether end_date participates. |

## Output

| Field | 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. |

## 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.

## Data Sources

- OpenWorkdays generated public-holiday and working-day data — https://openworkdays.com/api/v1/countries.json (open_derived_reference, retrieved 2026-09-28)

Data freshness: `static`. Pinned OpenWorkdays 2026-2028 snapshot.

## API

- `GET https://tttkmbb.com/api/v1/calculate/global-reference-working-days-between?start_date=…&end_date=…&territory=…`
- `POST https://tttkmbb.com/api/v1/calculate/global-reference-working-days-between` with JSON body `{"inputs": {…}}`
- Response: unified envelope (`success`, `request`, `result.values`, `result.units`, `sources`, `freshness`, `timestamp`, `next_actions`, `links`); see https://tttkmbb.com/docs/response-format.md
- Schema: https://tttkmbb.com/api/v1/calculators/global-reference-working-days-between · OpenAPI operationId `count_global_reference_working_days` in https://tttkmbb.com/openapi.json
- Authentication: none. Rate limit: fair use, see https://tttkmbb.com/docs/rate-limits.md.

## MCP

- Server: `https://tttkmbb.com/mcp` (Streamable HTTP, JSON-RPC 2.0, no auth)
- Tool: `count_global_reference_working_days` (dedicated) or `run_calculator` with `{"calculator_id": "global-reference-working-days-between", "inputs": {…}}`

## Example

- Australia October reference range: inputs `{"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
```

## Limitations

The range needs a direct official authority, regional/local or employer calendar, or dates outside 2026-2028. Normalize reversed endpoints, apply endpoint flags, and count source country weekends plus public-holiday events. All values are computed from the formula above; no measurement or live data is involved.

## 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

- [Global Working Day Reference](https://tttkmbb.com/everyday/global-reference-working-day.md) — Inspect one date.
- [Add Global Reference Working Days](https://tttkmbb.com/everyday/global-reference-add-working-days.md) — Add or subtract reference working days.