govuk bank holidays

GOV.UK 银行假期

该库加载 GOV.UK 提供的英国银行假日的官方列表。 GOV.UK 倾向于仅在未来一两年内提供此列表。

已知银行假日的缓存备份列表存储在该包中，但不经常更新。 GOV.UK 不再为某些旧年份提供银行假期，但仍属于此备用列表。

用法

使用pip install govuk-bank-holidays安装。使用示例：

 from govuk_bank_holidays . bank_holidays import BankHolidays

bank_holidays = BankHolidays ()
for bank_holiday in bank_holidays . get_holidays ():
    print ( bank_holiday [ 'title' ], 'is on' , bank_holiday [ 'date' ])
print ( bank_holidays . get_next_holiday ())

# see govuk_bank_holidays/bank_holidays.py source file for more methods and argument details…

# choose a different locale for holiday titles and notes
bank_holidays = BankHolidays ( locale = 'cy' )

# use cached holidays if internet connection is not desired
bank_holidays = BankHolidays ( use_cached_holidays = True )

英国各地的银行假期各不相同。 GOV.UK 来源目前列出了 3 个“部门”：

• 英格兰和威尔士
• 苏格兰
• 北爱尔兰

…该库中的许多方法都采用division参数（请参阅BankHolidays类上定义的常量）。

注意：如果未指定部门，则仅返回所有部门共有的假期，因此可能不会列出某些当地银行假期。因此，建议指定一个部门。

虽然本地化提供英语（默认区域设置代码“en”）和威尔士语（区域设置代码“cy”），但请注意，威尔士版本可能包含错误。

发展

请报告错误并在 GitHub 上打开拉取请求。

要对此库进行更改，建议以可编辑模式将其安装到虚拟环境中，即pip install --editable .

使用python scripts/update-cache.py从 GOV.UK 更新缓存的银行假日。

使用python scripts/messages.py update更新翻译文件，例如更新 i18n 模块或添加新语言时。使用python scripts/messages.py compile它们；这是测试和分发之前必需的。更新和编译翻译文件需要安装 gettext 系统包。

使用python -m tests在本地运行所有测试。或者，如果您有多个 python 版本，则可以使用tox 。

[仅适用于 GitHub 团队成员] 通过以下方式将新版本分发到 PyPI：

• 更新govuk_bank_holidays/__init__.py中的VERSION元组
• 向历史记录添加注释
• 在 GitHub 上发布一个版本，触发上传到 PyPI；或者，运行python scripts/messages.py compile; python -m build; twine upload dist/*

历史

0.15

更新了缓存的银行假日文件，以包含 GOV.UK 发布的最新假日。

0.14

将测试、构建和发布流程从已弃用的 setuptools 命令中迁移出来。翻译文件通过未包含在分发中的脚本进行更新和编译。 BankHolidays类有一个新的ALL_DIVISIONS常量。

0.13

该库与 0.12 没有区别。

0.12

删除了对 3.7 之前的 python 版本的支持。更新了缓存的银行假日文件，以包含 GOV.UK 发布的最新假日。将代码风格 linting 从单元测试移至 github 操作。添加了 setup.py 命令以更新 GOV.UK 缓存的银行假日。

0.11

更新了缓存的银行假日文件，以包含 GOV.UK 发布的最新假日。将 python 3.10 添加到测试矩阵。

0.10

添加了从给定日期开始之前/之后生成一系列假期和工作日的方法。

0.9

添加了查找以前银行假期/工作日的方法，反映了现有方法。删除了对 3.6 之前的 python 版本的支持。将 python 3.9 添加到测试矩阵。

0.8

该库与 0.7 没有区别。该版本是第一个使用 GitHub Actions 自动发布到 PyPI 的版本。

0.7

较小的文档更新。

0.6

更新了缓存的银行假日文件，以包含 GOV.UK 发布的最新假日。将 python 3.8 添加到测试矩阵。较小的文档更新。

0.5

更新了缓存的银行假日文件，以包含 GOV.UK 发布的最新假日。

0.4

更新了缓存的银行假日文件，以包含 GOV.UK 发布的最新假日。将 python 3.7 添加到测试矩阵。文档得到改进。

0.3

改进了测试。库不变。

0.2

更新了缓存的银行假日文件，以包含 GOV.UK 发布的最新假日。添加了强制使用缓存文件的选项。添加了下一个工作日的计算。

0.1

初次发布。

版权

版权所有 (C) 2023 英国政府（司法数字与技术部）。有关更多详细信息，请参阅 LICENSE.txt。