Skip to main content

Tool to load UK bank holidays from GOV.UK

Project description

This library loads the official list of bank holidays in the United Kingdom as supplied by GOV.UK. GOV.UK tend to provide this list for only a year or two into the future.


Install using pip install govuk-bank-holidays. Sample usage:

from govuk_bank_holidays.bank_holidays import BankHolidays

bank_holidays = BankHolidays()
for bank_holiday in bank_holidays.get_holidays():
    print(bank_holiday['title'], '>', bank_holiday['date'])
# see BankHolidays source file for more methods and arguments…

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

Bank holidays differ around the UK. The GOV.UK source currently lists these for 3 “divisions”:

  • England and Wales
  • Scotland
  • Northern Ireland

… and many methods in this library take a division parameter (c.f. constants on BankHolidays class).

NB: If no division is specified, only holidays common to all divisions are returned.


Please report bugs and open pull requests on GitHub.

Update translation files using python makemessages, e.g. when updating the i18n module or when adding new languages. Compile them using python compilemessages; this is required before testing and distribution.

Use python compilemessages test to run all tests.

Distribute a new version by updating the VERSION tuple in govuk_bank_holidays and run python compilemessages sdist bdist_wheel upload.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for govuk-bank-holidays, version 0.6
Filename, size File type Python version Upload date Hashes
Filename, size govuk_bank_holidays-0.6-py2.py3-none-any.whl (12.0 kB) File type Wheel Python version 3.7 Upload date Hashes View
Filename, size govuk-bank-holidays-0.6.tar.gz (10.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page