UK Bank holidays
This module checks whether a date is a UK bank holiday or not.
Add the module to your package.json:
yarn add @hmcts/uk-bank-holidays
Then, require the module in your code:
const UkBankHolidays = ;// Instantiate the class and pass the countries you care about.const ukbankholidays = 'england-and-wales';// Make an API call to load and cache the Bank Holidays dates, these dates are based on the countries.const bankHolidays = await ukbankholidays;// Now pass a date (DD-MM-YYYY) to the isDateABankHoliday() function which returns a boolean.const isDateABankHoliday = ukbankholidays; // returns true;
The countries that you pass when instantiating the class must be an array. For example, if you want
to check the date against the Scottish bank holiday dates then you can specify this but only passing
There are only three options you can pass for the countries:
['england-and-wales', 'northern-ireland', 'scotland'].
The date that you pass when checking if it's a bank holiday or not can either be a string or a moment.
If you pass a string, it must be in the following format:
In order to prevent multiple calls to the bank holidays api (which can be time costly),
the dates that come back in the response are cached. The default age of the caching is one week. However, you can change
this by setting an environment variable