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

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

ParameterTypeUnitRequiredDescription
datedateyesGregorian date from 2026-01-01 through 2028-12-31.
territoryenum: 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 | ZAyesISO-style alpha-2 country code supported by the pinned OpenHolidays public-holiday reference snapshot.

Outputs

OutputTypeUnitDescription
territorystringNormalized uppercase country code.
territory_namestringEnglish country name from the source catalogue.
weekdaystringGregorian weekday.
is_working_daybooleanTrue when the date is outside the CLDR weekend and has no included nationwide public-holiday event.
weekend_daysstring_listCLDR weekend convention used as the base rule.
holiday_namesstring_listIncluded nationwide public-holiday names on the date.
holiday_policystringNationwide public events only; regional and substitute-day rules are not inferred.
calendar_scopestringWeekday plus nationwide public-holiday reference.
calendar_profilestringglobal-public-holiday-reference.
substitute_day_policystringnot_inferred.
source_qualitystringOpen public-source aggregation, not a direct national authority feed.
dataset_versionstringPinned OpenHolidays snapshot version.
coverage_startdateFirst supported date.
coverage_enddateLast supported date.
source_commitstringImmutable 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

Sources

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