@rbs-path/public-holidays

public-holidays

Gets public holidays within specified timeframes

How to use

• install package

  npm install @rbs-path/public-holidays
  

  or

  yarn add @rbs-path/public-holidays
  

• require in code

  import getPublicHolidays from '@rbs-path/public-holidays'
  

  or

  const { getPublicHolidays } = require('@rbs-path/public-holidays)
  

• call getPublicHolidays with the specified params - dateRange and region

Param 1: dateRange (object)

dateRange is an object with the keys 'start' and 'end'. The values should be a string with the format 'YYYY-MM-DD'

i.e. { start: '2019-08-11', end: '2019-08-18' }

If no date range is supplied, the next public holiday from today will be returned.

If the date range object does not contain a start AND end key, an empty array will be returned.

Param 2: region

region is a string. Valid regions are 'england-and-wales', 'scotland' and 'northern-ireland'. If no daterange is supplied it will default to england-and-wales.

If an invalid region is requested an empty array will be returned.

Examples

• Get next public holiday (england-and-wales)

  const holidays = getPublicHolidays()
  

• Get next public holiday for Scotland

  const holidays = getPublicHolidays(null, 'scotland')
  

• Get public holidays in August 2019

  const holidays = getPublicHolidays({ start: '2019-08-01', end: '2019-08-31' }, 'northern-ireland')
  

  or without region (defaults to england-and-wales)

  const holidays = getPublicHolidays({ start: '2019-08-01', end: '2019-08-31' })