@18f/us-federal-holidays

US Federal Holidays

Builds and returns a list of all US federal holidays for a given year, and provides a helper method to determine if a given date is a US federal holiday. Handles shifting holidays to the nearest weekday if the holiday falls on a weekend.

Installation

npm install @18f/us-federal-holidays

Usage

To get a list of all US federal holidays in a given year, use the allForYear method. If no year is passed in, uses the current year.

var fedHolidays = require('us-federal-holidays');
var holidays = fedHolidays.allForYear(2016);

// Returns
[ { name: 'New Year\'s Day',
    date: Thu Dec 31 2015 18:00:00 GMT-0600 (CST),
    dateString: '2016-1-1' },
  { name: 'Birthday of Martin Luther King, Jr.',
    date: Sun Jan 17 2016 18:00:00 GMT-0600 (CST),
    dateString: '2016-1-18' },
  { name: 'Washington\'s Birthday',
    date: Sun Feb 14 2016 18:00:00 GMT-0600 (CST),
    dateString: '2016-2-15' },
  { name: 'Memorial Day',
    date: Sun May 29 2016 19:00:00 GMT-0500 (CDT),
    dateString: '2016-5-30' },
  { name: 'Independence Day',
    date: Sun Jul 03 2016 19:00:00 GMT-0500 (CDT),
    dateString: '2016-7-4' },
  { name: 'Labor Day',
    date: Sun Sep 04 2016 19:00:00 GMT-0500 (CDT),
    dateString: '2016-9-5' },
  { name: 'Columbus Day',
    date: Sun Oct 09 2016 19:00:00 GMT-0500 (CDT),
    dateString: '2016-10-10' },
  { name: 'Veterans Day',
    date: Thu Nov 10 2016 18:00:00 GMT-0600 (CST),
    dateString: '2016-11-11' },
  { name: 'Thanksgiving Day',
    date: Wed Nov 23 2016 18:00:00 GMT-0600 (CST),
    dateString: '2016-11-24' },
  { name: 'Christmas Day',
    date: Sun Dec 25 2016 18:00:00 GMT-0600 (CST),
    dateString: '2016-12-26' } ]

To determine if a date is a federal holiday, use the isAHoliday method. If no argument is provided, defaults to the current date:

var fedHolidays = require('us-federal-holidays');
var isAHoliday = fedHolidays.isAHoliday(myDate);
// Returns true or false

Timezones

Internally, all dates are stored in UTC. However, the isAHoliday method uses the timezone of the date object passed into it (or the timezone of the machine, if not argument is passed). Thus, if it is 10:00 PM Eastern Standard Time on December 25 and you call isAHoliday with no argument, it will return true, even though the UTC time would be 3:00 AM on December 26.

Public domain

This project is in the worldwide public domain. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.