跳转到主要内容

法国、大陆及海外节假日。

项目描述

Software License CircleCI PyPI - Downloads

Jours fériés France

此库计算法国的节假日。您可以在service-public.fr上了解更多有关法国节假日的详细信息。

此库从Python 2.7版本开始工作。

安装

pip install jours-feries-france

用法

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))

可用区域

以下区域可用

  • 大陆(默认)
  • 阿尔萨斯-摩泽尔
  • 瓜德罗普
  • 法属圭亚那
  • 留尼汪
  • 马提尼克
  • 马约特
  • 新喀里多尼亚
  • 法属波利尼西亚
  • 圣巴泰勒米
  • 圣马丁
  • 圣皮埃尔和密克隆
  • 瓦利斯和富图纳

这些区域在以下常量中可用

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'
# ]

法定节假日名称

法定节假日的名称由劳动法典规定。

对于默认的Metropolis(大都市)、新喀里多尼亚法属波利尼西亚圣皮埃尔和密克隆以及瓦利斯和富图纳地区,节假日的名称如下:

  • 1月1日
  • 复活节星期一
  • 5月1日
  • 5月8日
  • 升天节
  • 圣灵降临节星期一
  • 7月14日
  • 圣母升天节
  • 万圣节
  • 11月11日
  • 圣诞节

对于阿尔萨斯-洛林地区,有额外的2个节假日,名称如下:

  • 圣诞节第二天
  • 耶稣受难日

对于瓜德罗普圭亚那留尼汪马提尼克马约特圣巴泰勒米圣马丁地区,有额外的1个节假日,名称如下:

  • 奴隶制废除日

Python方法名称

您可以使用特定方法分别计算每个节假日。

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))

某些方法接受区域参数,因为该节假日特定于某些区域。如果传入的参数区域没有该节假日,您将返回None值而不是日期。

数据

如果您只需导出,请参阅data.gouv.fr上的数据集"法国节假日"

来源

节假日列表由劳动法典定义。

一些地方或职业纪念日也是节假日,其中包括:

  • 圣埃洛伊(在金属行业的一些集体合同中被认定为节假日);
  • 圣芭芭拉(矿工的节日);
  • 某些DOM地区的四旬节。

这些地方或职业性的节日不在此库中提供。

项目详细信息


下载文件

下载适用于您的平台文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源分布

jours_feries_france-0.7.0.tar.gz (4.9 kB 查看散列)

上传时间

支持者

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页