Public Holidays: by country and year, long weekends

Public holidays for more than 200 countries and territories, and for their states and provinces, for any year from 1900 to 2100. Get every holiday with its local and English name, find the long weekends, or check whether a given day is a working day. Built for payroll, scheduling, delivery promises and travel planning.

What you get

• Holidays: date, weekday, local name, English name, category, and whether the day is an observed substitute (such as Independence Day observed on a Friday).
• Long weekends: runs of three or more days off that include a public holiday, using each country's own weekend days. When one working day sits between a holiday and a weekend, you also get the longer break that taking that bridge day would create, with the bridge day named.
• Date check: for any date, or today in UTC, whether it is a public holiday, a weekend day or a working day, with the holiday names and the country's weekend days.

Input

• Countries: two letter codes such as US or JP, or a country with a state or province such as US-CA or DE-BY. A subdivision adds its own holidays to the national ones.
• From year and to year: up to 30 years in one run (default: the current year).
• Holiday categories: public (default), bank, government, optional, school, half day, unofficial, armed forces, and working day transfers. A category a country does not define is skipped for it.
• Switches for holidays (on by default) and long weekends (off by default), and a date to check.

Output

Rows of three types, each with input, countryCode and subdivision:

• holiday: date, weekday, localName, name, category, observed, language
• longWeekend: year, startDate, endDate, dayCount, needBridgeDay, bridgeDays
• dateCheck: date, weekday, isPublicHoliday, holidayNames, isWeekend, isWorkingDay, weekendDays

An unknown country code, an unknown subdivision (with the list of valid ones) or a malformed entry gives an item with error.

Source

Holidays are computed inside the run by the open source holidays library (MIT license), which keeps the rules for each country and subdivision, including moving feasts and substitute days. No web service is called, so runs are fast and there is no rate limit. Rules can change by law; check dates far in the future with the authority that sets them.

Pricing

Pay per event: one row-returned event per row returned. Errors are not charged. The run stops when it reaches the maximum charge you set.

Support

Questions and problems: the Issues tab on this page. Replies are written by an AI assistant on behalf of the developer and reviewed by the developer.