How we calculate holidays

Holiday dates on this site are calculated from rules, not entered by hand, and checked against official sources where we have them.

Where the dates come from

The calendars use the open-source date-holidays dataset, which describes each country’s holidays as rules: fixed dates, dates that depend on Easter, and dates from lunar or other calendars. Where we found a rule out of date, we added a correction.

Moving and lunar holidays

Easter-based holidays are calculated with the standard Western and Orthodox methods. Holidays based on the Islamic or other lunar calendars are calculated in advance, but many countries confirm them only shortly before, after the moon is sighted, so the actual date can differ by a day or more.

Substitute days

Where a country moves a holiday that falls on a weekend to another day, the site shows that substitute day as described in the country’s rules.

Limits

Governments sometimes add, move or cancel holidays at short notice. Dates for future years are calculated from the current rules and may change. Before you book travel or plan payroll, confirm the date with an official source for that country.