Tools/holidays/is_holiday

holidays/is_holiday

Check whether a specific date is a public holiday in a country.

Free / no pricing configured

What it does

Returns whether a given date is a public holiday in a country, and the holiday's name when it is.

Primary use cases

  • Business-day and SLA calculations ("is this date a working day?").
  • Gating scheduled jobs so they skip public holidays.

Good to know

Country codes are ISO 3166-1 alpha-2. Pass subdivision for region-specific holidays. Computed locally.

Parameters

datestringrequired

Date to check, YYYY-MM-DD.

countrystringrequired

ISO 3166-1 alpha-2 country code (e.g. US, GB, DE).

languagestringoptional

Optional language code for the localized holiday name.

subdivisionstringoptional

Optional ISO 3166-2 subdivision code (e.g. CA, NSW).

holidays/is_holiday — Faro