Jours fériés en France, en métropole et en outre-mer.
Project description
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6c702192ce794d1f1fd84913e80163067f407c546b17057712555148d4c770a2 |
|
MD5 | 108cee6f8adca034053be60f98c350f2 |
|
BLAKE2b-256 | 1e425365f1af7b0abca341581fbe25d7fa25127a01540a4ce7d7d501ae111281 |