Skip to main content

Get school holiday dates for metropolitan France

Project description

Software License CircleCI PyPI - Downloads

Vacances scolaires France

This package can be used to find the dates of school holidays in France, since 1990.

In French in the text: cette librairie permet de connaître les dates des vacances scolaires en France, depuis 1990, pour les zones A, B et C.

La répartition en trois zones de vacances A, B et C est définie de la façon suivante.

Septembre 1995 - Janvier 2016 :

  • Zone A : Académies de Caen, Clermont-Ferrand, Grenoble, Lyon, Montpellier, Nancy-Metz, Nantes, Rennes, Toulouse
  • Zone B : Académies d'Aix-Marseille, Amiens, Besançon, Dijon, Lille, Limoges, Nice, Orléans-Tours, Poitiers, Reims, Rouen , Strasbourg,
  • Zone C : Académies de Bordeaux, Créteil, Paris, Versailles

Depuis janvier 2016 :

  • Zone A : Académies de Besançon, Bordeaux, Clermont-Ferrand, Dijon, Grenoble, Limoges, Lyon, Poitiers
  • Zone B : Académies d'Aix-Marseille, Amiens, Caen, Lille, Nantes, Nice, Nancy-Metz, Orléans-Tours, Reims, Rennes, Rouen, Strasbourg
  • Zone C : Académies de Créteil, Montpellier, Paris, Versailles, Toulouse

Installation

pip install vacances-scolaires-france

Usage

from vacances_scolaires_france import SchoolHolidayDates

import datetime

d = SchoolHolidayDates()
# Is it an holiday for zone A, B or C?
d.is_holiday(datetime.date(2017, 12, 25))
# Returns: True

# Is it an holiday for a given zone?
d.is_holiday_for_zone(datetime.date(2009, 2, 7), 'A')
# Returns: True

# Get holidays for any zone in a year
d.holidays_for_year(2018)
# Returns: {datetime.date(2018, 1, 1): OrderedDict([('date', datetime.date(2018, 01, 01)), ('vacances_zone_a', True), ('vacances_zone_b', True), ('vacances_zone_c', True), ('nom_vacances', 'Vacances de Noël')]), ...}

# Get holiday dates given a year and an holiday name
d.holiday_for_year_by_name(2017, 'Vacances de la Toussaint')
# Returns: {datetime.date(2017, 10, 21): OrderedDict([('date', datetime.date(2017, 10, 21)), ('vacances_zone_a', True), ('vacances_zone_b', True), ('vacances_zone_c', True), ...}

# Get holiday dates for a given year and zone
d.holidays_for_year_and_zone(2017, 'A')
# Returns: {datetime.date(2017, 1, 1): OrderedDict([('date', datetime.date(2017, 01, 01)), ('vacances_zone_a', True), ('vacances_zone_b', True), ('vacances_zone_c', True), ...}

# Get holiday dates for a given year, zone and holiday name
d.holidays_for_year_zone_and_name(2017, 'A', 'Vacances de Noël')
# Returns: {datetime.date(2017, 1, 1): OrderedDict([('date', datetime.date(2017, 1, 1)), ('vacances_zone_a', True), ('vacances_zone_b', True), ('vacances_zone_c', True), ('nom_vacances', 'Vacances de Noël')]), ...}

Zone names

Use the capital letters A, B or C.

Holiday names

You can use the following holiday names:

  • Vacances de Noël
  • Vacances d'hiver
  • Vacances de printemps
  • Vacances d'été
  • Vacances de la Toussaint
  • Pont de l'Ascension (only for some years)

Data

School holiday dates are coming from the "Vacances scolaires par zones" opendata dataset available on data.gouv.fr.

Bank holidays

Interested in bank holidays as well (jours fériés in French)? There is another pip package for this! Check out https://github.com/AntoineAugusti/jours-feries-france

Notice

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.

Source Distribution

vacances_scolaires_france-0.7.1.tar.gz (41.5 kB view details)

Uploaded Source

Built Distribution

vacances_scolaires_france-0.7.1-py2.py3-none-any.whl (41.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file vacances_scolaires_france-0.7.1.tar.gz.

File metadata

  • Download URL: vacances_scolaires_france-0.7.1.tar.gz
  • Upload date:
  • Size: 41.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.7.7

File hashes

Hashes for vacances_scolaires_france-0.7.1.tar.gz
Algorithm Hash digest
SHA256 7f438c18b5dc4fb07acd2fd5706f808ed918c54392a7cd5c17cafbfd71186f64
MD5 2f98bc576d518fda95d6280c010f4857
BLAKE2b-256 66d0ca6c5cc349dd68626780d15e0fb85eaccea9f6dc2d6b02e67e2dd01aa5d0

See more details on using hashes here.

Provenance

File details

Details for the file vacances_scolaires_france-0.7.1-py2.py3-none-any.whl.

File metadata

  • Download URL: vacances_scolaires_france-0.7.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 41.6 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.26.0 CPython/3.7.7

File hashes

Hashes for vacances_scolaires_france-0.7.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 ce4750718d3b7cdaadfae4c2f7324a2e176b7377a86ab3af8d01a4341f947330
MD5 11e670c0c14af09c724d5daa0529a97a
BLAKE2b-256 a52139b7ef1c655c6b7075de78a997910f19b5a1e52510df47104575b86118b9

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