Home › Everyday Life › Global Public-Holiday Working Day Reference
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.
When to use
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.
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.
Inputs
| Parameter | Type | Unit | Required | Description |
|---|---|---|---|---|
date | date | yes | 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 | yes | ISO-style alpha-2 country code supported by the pinned OpenHolidays public-holiday reference snapshot. |
Outputs
| Output | 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. |
Example
Austria National Day: {"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
Machine access
- API:
GET https://tttkmbb.com/api/v1/calculate/global-public-holiday-working-day(query parameters) orPOSTwith a JSON body{"inputs": {...}} - Schema: https://tttkmbb.com/api/v1/calculators/global-public-holiday-working-day · Markdown: https://tttkmbb.com/everyday/global-public-holiday-working-day.md · JSON definition: https://tttkmbb.com/everyday/global-public-holiday-working-day.json
- MCP: server
https://tttkmbb.com/mcp, toolcheck_global_public_holiday_working_day - OpenAPI operationId:
check_global_public_holiday_working_day - Freshness:
static. Authentication: none. Rate limit: fair use (see rate limits).
Sources
- OpenHolidays API public-holiday data (open_data_aggregation)
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 calculators
- Global Working Day Baseline — Use for any CLDR territory when only weekend semantics are required.
- Mainland China Working Day Checker — Use the official mainland China package when China holidays and 调休 matter.
- UK Working Day Checker — Use the official GOV.UK division package for UK bank holidays.