holidays.countries.france

Classes

FR(*args, **kwargs)

FR is also used by dateutil (Friday), so be careful with this one.

FRA(*args, **kwargs)

param years:

France(*args, **kwargs)

Official French holidays.
class holidays.countries.france.France(*args, **kwargs)

Bases: HolidayBase, ChristianHolidays, InternationalHolidays

Official French holidays.

Some provinces have specific holidays, only those are included in the PROVINCES, because these provinces have different administrative status, which makes it difficult to enumerate.

For religious holidays usually happening on Sundays (Easter, Pentecost), only the following Monday is considered a holiday.

Primary sources:

https://fr.wikipedia.org/wiki/Fêtes_et_jours_fériés_en_France https://www.service-public.fr/particuliers/vosdroits/F2405

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 = 'FR'

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

default_language: str | None = 'fr'

The entity language used by default.

supported_languages: Tuple[str, ...] = ('en_US', 'fr', 'uk')

All languages supported by this entity.

subdivisions: Tuple[str, ...] = ('BL', 'GES', 'GP', 'GY', 'MF', 'MQ', 'NC', 'PF', 'RE', 'WF', 'YT')

The subdivisions supported for this country (see documentation).

class holidays.countries.france.FR(*args, **kwargs)

Bases: France

FR is also used by dateutil (Friday), so be careful with this one.

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.france.FRA(*args, **kwargs)

Bases: France

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.