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。