Skip to main content

Get bank holidays for France

Project description

Software License CircleCI

Jours Fériés France

This library computes bank holidays dates for France, for a given year.


pip install jours-feries-france


from jours_feries_france.compute import JoursFeries

res = JoursFeries.for_year(2018)
# res is now a dict
# {
#     'Armistice':, 11, 11),
#     'Ascension':, 5, 10),
#     'Assomption':, 8, 15),
#     'Fête Nationale':, 7, 14),
#     'Fête du travail':, 5, 1),
#     "Jour de l'an":, 1, 1),
#     'Lundi de Pâques':, 4, 2),
#     'Noël':, 12, 25),
#     'Lundi de Pentecôte':, 5, 21),
#     'Toussaint':, 11, 1),
#     'Victoire des alliés':, 5, 8)
# }

# You can also get specific bank holidays as a
print (JoursFeries.lundiDePaques(2018))
print (JoursFeries.ascension(2018))
print (JoursFeries.pentecote(2018))
print (JoursFeries.jourDeLAn(2018))
print (JoursFeries.feteDuTravail(2018))
print (JoursFeries.victoireDesAllies(2018))
print (JoursFeries.feteNationale(2018))
print (JoursFeries.toussaint(2018))
print (JoursFeries.assomption(2018))
print (JoursFeries.armistice(2018))
print (JoursFeries.noel(2018))

# The Alsace-Moselle region has 2 extra bank holidays.
# You can include them this way
res = JoursFeries.for_year(2018, include_alsace=True)

print (JoursFeries.vendrediSaint(2018))
print (JoursFeries.saintEtienne(2018))


If you just want a CSV dump, check out the "Jours fériés en France" opendata dataset available on


Looking for a JSON API? Check out this GitHub project.

School holidays

Interested in school holidays as well (vacances scolaires in French)? There is another pip package for this! Check out


This software is available under the MIT license and was developed as part of the Entrepreneur d'Intérêt Général program by the French government.

Projet développé dans le cadre du programme « Entrepreneur d’intérêt général ».

Project details

Download files

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

Files for jours-feries-france, version 0.4
Filename, size File type Python version Upload date Hashes
Filename, size jours_feries_france-0.4-py2.py3-none-any.whl (4.4 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size jours_feries_france-0.4.tar.gz (3.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page