holidays.countries.australia

Classes

AU(*args, **kwargs)

param years:

AUS(*args, **kwargs)

param years:

Australia(*args, **kwargs)

References:

AustraliaStaticHolidays()

class holidays.countries.australia.Australia(*args, **kwargs)

Bases: ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays

References:
Parameters:

  • years – The year(s) to pre-calculate public holidays for at instantiation.

  • expand – Whether the entire year is calculated when one date from that year is requested.

  • observed – Whether to include the dates when public holiday are observed (e.g. a holiday falling on a Sunday being observed the following Monday). This doesn’t work for all countries.

  • subdiv – The subdivision (e.g. state or province) as a ISO 3166-2 code or its alias; not implemented for all countries (see documentation).

  • prov – deprecated use subdiv instead.

  • state – deprecated use subdiv instead.

  • language – The language which the returned holiday names will be translated into. It must be an ISO 639-1 (2-letter) language code. If the language translation is not supported the original holiday names will be used.

  • categories – Requested holiday categories.

Returns:

A HolidayBase object matching the country.

country: str = 'AU'

The country’s ISO 3166-1 alpha-2 code.

supported_categories: Tuple[str, ...] = ('bank', 'half_day', 'public')

All holiday categories supported by this entity.

observed_label = '%s (observed)'
subdivisions: Tuple[str, ...] = ('ACT', 'NSW', 'NT', 'QLD', 'SA', 'TAS', 'VIC', 'WA')

The subdivisions supported for this country (see documentation).

subdivisions_aliases: Dict[str, str] = {'Australian Capital Territory': 'ACT', 'New South Wales': 'NSW', 'Northern Territory': 'NT', 'Queensland': 'QLD', 'South Australia': 'SA', 'Tasmania': 'TAS', 'Victoria': 'VIC', 'Western Australia': 'WA'}

Aliases for the ISO 3166-2 subdivision codes with the key as alias and the value the ISO 3166-2 subdivision code.

property sovereign_birthday: str

Sovereign’s birthday holiday name.

class holidays.countries.australia.AU(*args, **kwargs)

Bases: Australia

Parameters:

  • years – The year(s) to pre-calculate public holidays for at instantiation.

  • expand – Whether the entire year is calculated when one date from that year is requested.

  • observed – Whether to include the dates when public holiday are observed (e.g. a holiday falling on a Sunday being observed the following Monday). This doesn’t work for all countries.

  • subdiv – The subdivision (e.g. state or province) as a ISO 3166-2 code or its alias; not implemented for all countries (see documentation).

  • prov – deprecated use subdiv instead.

  • state – deprecated use subdiv instead.

  • language – The language which the returned holiday names will be translated into. It must be an ISO 639-1 (2-letter) language code. If the language translation is not supported the original holiday names will be used.

  • categories – Requested holiday categories.

Returns:

A HolidayBase object matching the country.

class holidays.countries.australia.AUS(*args, **kwargs)

Bases: Australia

Parameters:

  • years – The year(s) to pre-calculate public holidays for at instantiation.

  • expand – Whether the entire year is calculated when one date from that year is requested.

  • observed – Whether to include the dates when public holiday are observed (e.g. a holiday falling on a Sunday being observed the following Monday). This doesn’t work for all countries.

  • subdiv – The subdivision (e.g. state or province) as a ISO 3166-2 code or its alias; not implemented for all countries (see documentation).

  • prov – deprecated use subdiv instead.

  • state – deprecated use subdiv instead.

  • language – The language which the returned holiday names will be translated into. It must be an ISO 639-1 (2-letter) language code. If the language translation is not supported the original holiday names will be used.

  • categories – Requested holiday categories.

Returns:

A HolidayBase object matching the country.

class holidays.countries.australia.AustraliaStaticHolidays

Bases: object

special_public_holidays = {2022: (9, 22, 'National Day of Mourning for Queen Elizabeth II')}
special_act_public_holidays = {2020: (4, 20, 'Declared public holiday'), 2021: (4, 25, 'Additional public holiday')}
special_qld_public_holidays = {2012: (6, 11, "Queen's Diamond Jubilee")}
special_qld_public_holidays_observed = {2010: (12, 28, 'Christmas Day'), 2011: (1, 3, "New Year's Day")}
special_wa_public_holidays = {2011: (4, 26, 'Special public holiday')}