calendra 3.0

概述

calendra是一个python模块，它提供能够处理日历的类， 列出法定/宗教假日，并给出与工作日相关的计算 功能。

历史记录

卡伦德拉是Workalendar的叉子 设计为更具扩展性和内省性，在 Workalendar is philosophically opposed for the sake of simplicity。

卡伦德拉能做什么呢

• 提供每个“指定日期”的假日说明 假日（例如“八月的第三个星期一”）
• 保持假日的指定日期和观察日期的清晰性，例如 可以确定某一天的假日是在哪一天
• 允许计算日历年中的假日数。
• 在核心代码中合并遵守逻辑，而不是要求 每个日历实现都要实现自己的。

状态

该项目稳定，已投入生产使用卡伦德拉遵循原则 对于发布的verisons。

使用示例

>>>fromdatetimeimportdate>>>fromcalendra.europeimportFrance>>>cal=France()>>>cal.holidays(2012)[(datetime.date(2012,1,1),'New year'),(datetime.date(2012,4,9),'Easter Monday'),(datetime.date(2012,5,1),'Labour Day'),(datetime.date(2012,5,8),'Victory in Europe Day'),(datetime.date(2012,5,17),'Ascension Day'),(datetime.date(2012,5,28),'Whit Monday'),(datetime.date(2012,7,14),'Bastille Day'),(datetime.date(2012,8,15),'Assumption of Mary to Heaven'),(datetime.date(2012,11,1),"All Saints' Day"),(datetime.date(2012,11,11),'Armistice Day'),(datetime.date(2012,12,25),'Christmas')]>>>cal.is_working_day(date(2012,12,25))# it's ChristmasFalse>>>cal.is_working_day(date(2012,12,30))# it's SundayFalse>>>cal.is_working_day(date(2012,12,26))True>>>cal.add_working_days(date(2012,12,23),5)# 5 working days after Xmasdatetime.date(2012,12,31)

有关更完整的文档和高级用法，请转到 the official workalendar documentation

外部依赖性

您可能希望在计算机上安装python-dev和/或python3-dev以 要么运行安装程序，要么通过tox运行测试。

Workalendar已经在Python2.7、3.4、3.5、3.6、3.7上进行了测试

测试

特拉维斯状态：

要运行测试，只需使用pip install tox安装tox并运行：

tox

从命令行。

可用日历

注意事项

请注意，有些日历并非100%准确。最常见的 例如伊斯兰日历，其中一些计算的假日并不完全在 由宗教当局决定的同一天，这可能会有所不同 一个国家一个国家。只要有可能，试着调整你的结果 有关当局提供的官方数据。

贡献

请阅读我们的CONTRIBUTING.rst 文档以了解如何为calendra做出贡献。拉取请求 很受欢迎。

许可证

这个图书馆是根据麻省理工学院的许可条款出版的。请检查 有关详细信息的许可证文件S.