Holidays
Generate the dates of common North American and Jewish holidays.
Jewish holidays begin the sunset before the first (secular) day of the holiday
With the eve
option set to True
, the day of this sunset is returned
without the eve
option, the (secular) day is returned. This is the default.
- class convertdate.holidays.Holidays(year=None)
Convenience class for fetching many holidays in a given year.
- property ashura
- property christmas
- property christmas_eve
- property columbus_day
- property dia_constitucion
- property dia_independencia
- property dia_revolucion
- property easter
- property eid_aladha
- property eid_alfitr
- property election_day
- property fathers_day
- property flag_day
- property halloween
- property hanukkah
- property independence_day
- property indigenous_peoples_day
- property juneteenth
- property labor_day
- property lag_baomer
- property lincolns_birthday
- property martin_luther_king_day
- property memorial_day
- property mothers_day
- property natalicio_benito_juarez
- property new_years
- property new_years_eve
- property passover
- property presidents_day
- property pulaski_day
- property purim
- property ramadan
- property rosh_hashanah
- set_year(year)
- property shavuot
- property shemini_azeret
- property sukkot
- property thanksgiving
- property tisha_bav
- property tu_beshvat
- property valentines_day
- property veterans_day
- property washingtons_birthday
- property yom_kippur
- convertdate.holidays.armistice_day(year)
- convertdate.holidays.ashura(year, eve=None)
Ashura is celebrated on the tenth day of Muharram, the first month in the Islamic calendar.
- convertdate.holidays.christmas(year, observed=None)
Christmas is celebrated on the 25th of December. For the purposes of business closings, it may be observed on the previous or following day if the 25th falls on a Saturday or Sunday, respectively.
- Arguments:
year (int): Gregorian year observed (boolean): If
True
, return the date of observation.
- convertdate.holidays.christmas_eve(year)
The day before Christmas, or 24th of December.
- convertdate.holidays.columbus_day(year, country='usa')
- convertdate.holidays.dia_constitucion(year, observed=True)
Constitution Day, a public holiday in Mexico observed on the first Monday in February.
- convertdate.holidays.dia_independencia(year)
Mexican independence day, observed on September 16.
- convertdate.holidays.dia_revolucion(year)
Revolution Day, a public holiday in Mexico observed on the third Monday in November.
- convertdate.holidays.easter(year, church=None)
Calculate Easter in the given church according to the given calendar.
- convertdate.holidays.eid_aladha(year, eve=None)
Eid al-Adha, the ‘Festival of the Sacrifice’ begins on the tenth day of the month of Zū al-Ḥijjah.
- convertdate.holidays.eid_alfitr(year, eve=None)
Eid al-Fitr, the ‘Festival of Breaking the Fast’ is celebrated the first day of the month of Shawwāl.
- convertdate.holidays.election_day(year)
In most jurisdictions in the United States, Election day occurs on the first Tuesday in November.
- convertdate.holidays.fathers_day(year)
3rd Sunday in June
- convertdate.holidays.flag_day(year)
June 14th
- convertdate.holidays.halloween(year)
Halloween is celebrated on October 31st.
- convertdate.holidays.hanukkah(year, eve=None)
- convertdate.holidays.independence_day(year, observed=None)
Independence Day in the United States, celebrated on July 4th. May be observed on the previous or following day if it occurs on a Saturday or Sunday.
- Arguments:
year (int): Gregorian year observed (boolean): If
True
, return the date of observation.
- convertdate.holidays.indigenous_peoples_day(year, country='usa')
Celebrated on the second Monday in October in the United States.
- convertdate.holidays.juneteenth(year)
19th of June
- convertdate.holidays.labor_day(year)
first Monday in Sep
- convertdate.holidays.lag_baomer(year, eve=None)
- convertdate.holidays.lincolns_birthday(year)
Feb 12
- convertdate.holidays.martin_luther_king_day(year)
third monday in January
- convertdate.holidays.may_day(year)
- convertdate.holidays.memorial_day(year)
last Monday in May
- convertdate.holidays.mothers_day(year)
2nd Sunday in May
- convertdate.holidays.natalicio_benito_juarez(year, observed=True)
Benito Juárez’s Birthday, a public holiday in Mexico observed on the third Monday in March.
- convertdate.holidays.new_years(year, observed=None)
Jan 1st, possibly observed on last day of previous year
- convertdate.holidays.new_years_eve(year)
The last day of the Gregorian year, December. 31st.
- convertdate.holidays.passover(year, eve=None)
- convertdate.holidays.presidents_day(year)
3rd Monday of Feb
- convertdate.holidays.pulaski_day(year)
1st monday in March
- convertdate.holidays.purim(year, eve=None)
- convertdate.holidays.ramadan(year, eve=None)
The first day of Ramadan, the month of fasting in the Islamic calendar.
- convertdate.holidays.rememberance_day(year)
- convertdate.holidays.rosh_hashanah(year, eve=None)
- convertdate.holidays.shavuot(year, eve=None)
- convertdate.holidays.shemini_azeret(year, eve=None)
- convertdate.holidays.sukkot(year, eve=None)
Sukkot, the Feast of Tabernacles or Festival of Shelters, is celebrated on the 15th of Tishri.
- convertdate.holidays.thanksgiving(year, country='usa')
In the United States, Thanksgiving is celebrated on the last Thursday of November. In Canada, on the second Monday of October.
- Arguments:
year (int): Gregorian year country (str): either
'usa'
(default) or'canada'
- convertdate.holidays.tisha_bav(year, eve=None)
Tisha B’Av is a fast day generally celebrated on the 9th of Av, but sometimes postponed to the following day.
- convertdate.holidays.tu_beshvat(year, eve=None)
Tu BeShvat, the ‘New Year of Trees’, is celebrated on the 15th of Shevat.
- convertdate.holidays.valentines_day(year)
feb 14th
- convertdate.holidays.veterans_day(year, observed=None)
Nov 11, or the following closest weekday
- convertdate.holidays.washingtons_birthday(year, observed=None)
Feb 22, possibly observed on 3rd Monday in February
- convertdate.holidays.yom_kippur(year, eve=None)