# Global Public-Holiday Working Day Reference

> Checks a date for a supported country using CLDR weekend rules plus nationwide public-holiday events from a pinned OpenHolidays open-data snapshot, with explicit non-authority and substitute-day limits.

- Calculator id: `global-public-holiday-working-day` · Category: Everyday Life (`everyday`) · Tool name: `check_global_public_holiday_working_day`
- Canonical page: https://tttkmbb.com/everyday/global-public-holiday-working-day · This document: https://tttkmbb.com/everyday/global-public-holiday-working-day.md · JSON definition: https://tttkmbb.com/everyday/global-public-holiday-working-day.json

## Purpose

Checks a date for a supported country using CLDR weekend rules plus nationwide public-holiday events from a pinned OpenHolidays open-data snapshot, with explicit non-authority and substitute-day limits.

**Use when:** You need a source-labelled 2026-2028 public-holiday reference for one of the supported OpenHolidays countries and nationwide-only semantics are acceptable.

**Do not use when:** You need an official direct authority result, regional/local holidays, substitute-day rules, employer/bank/exchange closures, or a date outside 2026-2028; use the verified China/UK package or the CLDR baseline as appropriate.

## Example user requests

- Is 2026-10-26 a working day in Austria after nationwide public holidays are excluded?
- Check 2027-05-01 in France using the OpenHolidays nationwide reference.


## Input

| Parameter | Type | Unit | Required | Description |
| --- | --- | --- | --- | --- |
| `date` | date |  | required | Gregorian date from 2026-01-01 through 2028-12-31. |
| `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 |  | required | ISO-style alpha-2 country code supported by the pinned OpenHolidays public-holiday reference snapshot. |

## Output

| Field | Type | Unit | Description |
| --- | --- | --- | --- |
| `territory` | string |  | Normalized uppercase country code. |
| `territory_name` | string |  | English country name from the source catalogue. |
| `weekday` | string |  | Gregorian weekday. |
| `is_working_day` | boolean |  | True when the date is outside the CLDR weekend and has no included nationwide public-holiday event. |
| `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. |

## Formula

`is_working_day = CLDR weekday(date) and no included nationwide public-holiday event(date, territory)`

Resolve the CLDR weekend rule and compare the date with the pinned nationwide Public events. Regional events and observed/substitute rules are not added unless the source explicitly lists them as events.

## Data Sources

- OpenHolidays API public-holiday data — https://openholidaysapi.org/PublicHolidays (open_data_aggregation, retrieved 2026-09-29)

Data freshness: `static`. Pinned OpenHolidays 2026-2028 snapshot; data updates require an explicit source review and candidate release.

## API

- `GET https://tttkmbb.com/api/v1/calculate/global-public-holiday-working-day?date=…&territory=…`
- `POST https://tttkmbb.com/api/v1/calculate/global-public-holiday-working-day` 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-public-holiday-working-day · OpenAPI operationId `check_global_public_holiday_working_day` 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: `check_global_public_holiday_working_day` (dedicated) or `run_calculator` with `{"calculator_id": "global-public-holiday-working-day", "inputs": {…}}`

## Example

- Austria National Day: inputs `{"date":"2026-10-26","territory":"AT"}` → `{"is_working_day":false,"holiday_names":["National Day"]}`

```
GET https://tttkmbb.com/api/v1/calculate/global-public-holiday-working-day?date=2026-10-26&territory=AT
```

## Limitations

You need an official direct authority result, regional/local holidays, substitute-day rules, employer/bank/exchange closures, or a date outside 2026-2028; use the verified China/UK package or the CLDR baseline as appropriate. Resolve the CLDR weekend rule and compare the date with the pinned nationwide Public events. Regional events and observed/substitute rules are not added unless the source explicitly lists them as events. All values are computed from the formula above; no measurement or live data is involved.

## FAQ

**Is this an official national calendar?**

No. It is an open public-source aggregation with explicit provenance; verify material decisions against the responsible authority.

**Does it include substitute days?**

No substitute-day rule is inferred. The result returns substitute_day_policy=not_inferred.

**Does it include regional holidays?**

No. Only events marked nationwide by the snapshot are included.

## Related

- [Global Working Day Baseline](https://tttkmbb.com/everyday/global-working-day.md) — Use for any CLDR territory when only weekend semantics are required.
- [Mainland China Working Day Checker](https://tttkmbb.com/everyday/china-working-day.md) — Use the official mainland China package when China holidays and 调休 matter.
- [UK Working Day Checker](https://tttkmbb.com/everyday/uk-working-day.md) — Use the official GOV.UK division package for UK bank holidays.