Skip to main content

Jours fériés en France, en métropole et en outre-mer.

Project description

Software License CircleCI PyPI - Downloads

Jours fériés France

Cette librairie calcule les jours fériés en France. Vous pouvez découvrir plus de détails sur les jours fériés français sur service-public.fr.

Cette librairie fonctionne à partir de la version 2.7 de Python.

Installation

pip install jours-feries-france

Usage

import datetime

from jours_feries_france import JoursFeries

# Obtenir les jours fériés pour une année, pour la métropole
res = JoursFeries.for_year(2018)
# res est un dictionnaire
# {
#     '1er janvier': datetime.date(2018, 1, 1),
#     'Lundi de Pâques': datetime.date(2018, 4, 2),
#     '1er mai': datetime.date(2018, 5, 1),
#     '8 mai': datetime.date(2018, 5, 8),
#     'Ascension': datetime.date(2018, 5, 10),
#     'Lundi de Pentecôte': datetime.date(2018, 5, 21),
#     '14 juillet': datetime.date(2018, 7, 14),
#     'Assomption': datetime.date(2018, 8, 15),
#     'Toussaint': datetime.date(2018, 11, 1),
#     '11 novembre': datetime.date(2018, 11, 11),
#     'Jour de Noël': datetime.date(2018, 12, 25)
# }

# Vous pouvez aussi obtenir certains jours fériés en tant que datetime.date
print (JoursFeries.lundi_paques(2018))
print (JoursFeries.ascension(2018))
print (JoursFeries.lundi_pentecote(2018))

# Obtenir les jours fériés pour une zone spécifique
res = JoursFeries.for_year(2018, zone="Alsace-Moselle")

# Quelques fonctions d'aide
JoursFeries.is_bank_holiday(datetime.date(2019, 12, 25), zone="Métropole")
# -> True
JoursFeries.next_bank_holiday(datetime.date(2019, 12, 24), zone="Métropole")
# -> ('Noël', datetime.date(2019, 12, 25))

Zones disponibles

Les zones suivantes sont disponibles :

  • Métropole (par défaut)
  • Alsace-Moselle
  • Guadeloupe
  • Guyane
  • La Réunion
  • Martinique
  • Mayotte
  • Nouvelle-Calédonie
  • Polynésie Française
  • Saint-Barthélémy
  • Saint-Martin
  • Saint-Pierre-et-Miquelon
  • Wallis-et-Futuna

Ces zones sont disponibles dans une constante :

from jours_feries_france import JoursFeries

print(JoursFeries.ZONES)
# [
#     'Métropole', 'Alsace-Moselle', 'Guadeloupe',
#     'Guyane', 'Martinique', 'Mayotte', 'Nouvelle-Calédonie',
#     'La Réunion', 'Polynésie Française', 'Saint-Barthélémy',
#     'Saint-Martin', 'Wallis-et-Futuna', 'Saint-Pierre-et-Miquelon'
# ]

Noms des jours fériés

Les noms des jours fériés sont fixés d'après le code du travail.

Pour les zones Métropole (par défaut), Nouvelle-Calédonie, Polynésie Française, Saint-Pierre-et-Miquelon et Wallis-et-Futuna, les jours fériés sont orthographiés de la façon suivante :

  • 1er janvier
  • Lundi de Pâques
  • 1er mai
  • 8 mai
  • Ascension
  • Lundi de Pentecôte
  • 14 juillet
  • Assomption
  • Toussaint
  • 11 novembre
  • Jour de Noël

Pour la zone Alsace-Moselle, il existe 2 jours fériés supplémentaires, orthographiés de la façon suivante :

  • 2ème jour de Noël
  • Vendredi saint

Pour les zones Guadeloupe, Guyane, La Réunion, Martinique, Mayotte, Saint-Barthélémy et Saint-Martin, il existe un jour férié supplémentaire, orthographié de la façon suivante :

  • Abolition de l'esclavage

Noms des méthodes Python

Vous pouvez calculer chaque jour férié individuellement à l'aide d'une méthode spécifique.

from jours_feries_france import JoursFeries

year = 2020
zone = 'Métropole'

print("1er janvier", JoursFeries.premier_janvier(year))
print("1er mai", JoursFeries.premier_mai(year))
print("8 mai", JoursFeries.huit_mai(year))
print("14 juillet", JoursFeries.quatorze_juillet(year))
print("Assomption", JoursFeries.assomption(year))
print("Toussaint", JoursFeries.toussaint(year))
print("11 novembre", JoursFeries.onze_novembre(year))
print("Jour de Noël", JoursFeries.jour_noel(year))
print("Lundi de Pâques", JoursFeries.lundi_paques(year))
print("Ascension", JoursFeries.ascension(year))
print("Lundi de Pentecôte", JoursFeries.lundi_pentecote(year))
print("Vendredi saint", JoursFeries.vendredi_saint(year, zone))
print("2ème jour de Noël", JoursFeries.deuxieme_jour_noel(year, zone))
print("Abolition de l'esclavage", JoursFeries.abolition_esclavage(year, zone))

Certaines méthodes acceptent une zone en paramètre car ce jour férié est spécifique à certaines zones. Si ce jour férié n'est pas férié pour la zone passée en argument, vous aurez la valeur None en retour au lieu d'une date.

Données

Si vous souhaitez simplement un export, consultez le jeu de données "Jours fériés en France" sur data.gouv.fr.

Sources

La liste des jours fériés est définie dans le code du travail.

Certaines commémorations locales ou professionnelles sont également des jours fériés, parmi lesquelles :

  • Saint-Éloi (reconnu jour férié par certaines conventions collectives dans la métallurgie) ;
  • Sainte-Barbe (pour les salariés travaillant dans les mines) ;
  • Mi-carême dans certains DOM.

Ces fêtes locales ou professionnelles ne sont pas disponibles dans cette librairie.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jours_feries_france-0.7.0.tar.gz (4.9 kB view details)

Uploaded Source

File details

Details for the file jours_feries_france-0.7.0.tar.gz.

File metadata

  • Download URL: jours_feries_france-0.7.0.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.7

File hashes

Hashes for jours_feries_france-0.7.0.tar.gz
Algorithm Hash digest
SHA256 6c702192ce794d1f1fd84913e80163067f407c546b17057712555148d4c770a2
MD5 108cee6f8adca034053be60f98c350f2
BLAKE2b-256 1e425365f1af7b0abca341581fbe25d7fa25127a01540a4ce7d7d501ae111281

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page