Data & methodology

How the dates are produced, and how far to trust them.

Source

National public holiday dates come from python-holidays (version 0.108), an open-source, community-maintained library that encodes each country's holiday laws. Country names follow ISO 3166 via pycountry and the Unicode CLDR. Glassyear compiles these into a dataset for 2026–2028 and computes everything else itself: countdowns, long weekends, bridge days, month views, and the countries sharing each holiday.

Languages

Glassyear is published in English, French, Spanish, Portuguese and Chinese. Country names, dates and weekdays come from the Unicode CLDR. Holiday names use each country's official name where the source provides one in that language, then a reviewed translation table for the most common holidays; rare local holidays keep their official English name.

What is included

National (country-wide) public holidays, including “observed” days when a holiday moves off a weekend. Regional, state, school and bank-only holidays are not included. Observances such as Valentine's Day, Halloween and the seasons are shown separately and are clearly marked as not being public holidays.

Estimated dates

Holidays on the Islamic and other lunar calendars are calculated in advance and marked estimated. Authorities confirm them after the moon is sighted, and the final date can move by a day.

Long weekends

A long weekend is three or more consecutive days off that include at least one holiday falling on a working day. Bridge days are single working days that, taken off, join a holiday to a weekend for four days or more. We assume a Saturday–Sunday weekend, except in countries with a different official weekend (for example Friday and Saturday in Saudi Arabia, Egypt and Israel).

Time

Countdowns run to midnight at the start of the holiday in your time zone. “Today” on Glassyear means today where you are.

Corrections

Governments add and move holidays, sometimes at short notice. If you see a wrong date, write to hello@glassyear.com and we will fix it.

License notice

python-holidays is distributed under the MIT License. Copyright © Vacanza Team and individual contributors; dr-prodigy 2017–2023; ryanss 2014–2017. The MIT License permits use, copying, modification and distribution, provided this notice is included. The library is provided “as is”, without warranty of any kind.