us federal holidays

Jours fériés fédéraux aux États-Unis

Construit et renvoie une liste de tous les jours fériés fédéraux américains pour une année donnée et fournit une méthode d'aide pour déterminer si une date donnée est un jour férié fédéral américain. Gère le décalage des jours fériés vers le jour de la semaine le plus proche si le jour férié tombe un week-end.

Les jours fériés fédéraux aux États-Unis sont tels que définis par OPM.

Installation

 npm install @18f/us-federal-holidays

Nécessite Node.js 12 ou supérieur.

Usage

Pour obtenir une liste de tous les jours fériés fédéraux américains au cours d’une année donnée, utilisez la méthode allForYear . Si aucune année n’est indiquée, utilise l’année en cours.

 const fedHolidays = require ( '@18f/us-federal-holidays' ) ;

const options = { shiftSaturdayHolidays : true , shiftSundayHolidays : true } ;
const holidays = fedHolidays . allForYear ( 2016 , options ) ;

// Returns
[ { name : 'New Year's Day' ,
    date : 2016 - 01 - 01 T00 : 00 : 00 .000 Z ,
    dateString : '2016-1-1' } ,
  { name : 'Birthday of Martin Luther King, Jr.' ,
    date : 2016 - 01 - 18 T00 : 00 : 00 .000 Z ,
    dateString : '2016-1-18' } ,
  { name : 'Washington's Birthday' ,
    alsoObservedAs : 'Presidents' Day' ,
    date : 2016 - 02 - 15 T00 : 00 : 00 .000 Z ,
    dateString : '2016-2-15' } ,
  { name : 'Memorial Day' ,
    date : 2016 - 05 - 30 T00 : 00 : 00 .000 Z ,
    dateString : '2016-5-30' } ,
  {
    name : 'Juneteenth National Independence Day' ,
    date : 2016 - 06 - 20 T00 : 00 : 00 .000 Z ,
    dateString : '2016-6-20' } ,
  { name : 'Independence Day' ,
    date : 2016 - 07 - 04 T00 : 00 : 00 .000 Z ,
    dateString : '2016-7-4' } ,
  { name : 'Labor Day' ,
    date : 2016 - 09 - 05 T00 : 00 : 00 .000 Z ,
    dateString : '2016-9-5' } ,
  { name : 'Columbus Day' ,
    alsoObservedAs : 'Indigenous Peoples' Day' ,
    date : 2016 - 10 - 10 T00 : 00 : 00 .000 Z ,
    dateString : '2016-10-10' } ,
  { name : 'Veterans Day' ,
    date : 2016 - 11 - 11 T00 : 00 : 00 .000 Z ,
    dateString : '2016-11-11' } ,
  { name : 'Thanksgiving Day' ,
    date : 2016 - 11 - 24 T00 : 00 : 00 .000 Z ,
    dateString : '2016-11-24' } ,
  { name : 'Christmas Day' ,
    date : 2016 - 12 - 26 T00 : 00 : 00 .000 Z ,
    dateString : '2016-12-26' } ]

Pour obtenir une liste de tous les jours fériés fédéraux américains au sein d’une plage de dates, utilisez la méthode inRange . Si aucune date start n’est fournie, utilise la date actuelle. Si la date de fin est omise, un an à compter de la date actuelle est utilisé.

 const fedHolidays = require ( '@18f/us-federal-holidays' ) ;
const start = new Date ( '2016-02-13' ) ;
const end = new Date ( '2017-07-23' ) ;
const options = { shiftSaturdayHolidays : true , shiftSundayHolidays : true } ;
const holidays = fedHolidays . inRange ( start , end , options ) ;

// Returns
[ { name : 'Washington's Birthday' ,
    date : 2016 - 02 - 15 T00 : 00 : 00 .000 Z ,
    dateString : '2016-2-15' } ,
  { name : 'Memorial Day' ,
    date : 2016 - 05 - 30 T00 : 00 : 00 .000 Z ,
    dateString : '2016-5-30' } ,
  {
    name : 'Juneteenth National Independence Day'
    date : 2016 - 06 - 20 T00 : 00 : 00 .000 Z ,
    dateString : '2016-6-20' } ,
  { name : 'Independence Day' ,
    date : 2016 - 07 - 04 T00 : 00 : 00 .000 Z ,
    dateString : '2016-7-4' } ,
  { name : 'Labor Day' ,
    date : 2016 - 09 - 05 T00 : 00 : 00 .000 Z ,
    dateString : '2016-9-5' } ,
  { name : 'Columbus Day' ,
    alsoObservedAs : 'Indigenous Peoples' Day' ,
    date : 2016 - 10 - 10 T00 : 00 : 00 .000 Z ,
    dateString : '2016-10-10' } ,
  { name : 'Veterans Day' ,
    date : 2016 - 11 - 11 T00 : 00 : 00 .000 Z ,
    dateString : '2016-11-11' } ,
  { name : 'Thanksgiving Day' ,
    date : 2016 - 11 - 24 T00 : 00 : 00 .000 Z ,
    dateString : '2016-11-24' } ,
  { name : 'Christmas Day' ,
    date : 2016 - 12 - 26 T00 : 00 : 00 .000 Z ,
    dateString : '2016-12-26' } ,
  { name : 'New Year's Day' ,
    date : 2017 - 01 - 02 T00 : 00 : 00 .000 Z ,
    dateString : '2017-1-2' } ,
  { name : 'Birthday of Martin Luther King, Jr.' ,
    date : 2017 - 01 - 16 T00 : 00 : 00 .000 Z ,
    dateString : '2017-1-16' } ,
  { name : 'Washington's Birthday' ,
    alsoObservedAs : 'Presidents' Day' ,
    date : 2017 - 02 - 20 T00 : 00 : 00 .000 Z ,
    dateString : '2017-2-20' } ,
  { name : 'Memorial Day' ,
    date : 2017 - 05 - 29 T00 : 00 : 00 .000 Z ,
    dateString : '2017-5-29' } ,
  {
    name : 'Juneteenth National Independence Day'
    date : 2017 - 06 - 19 T00 : 00 : 00 .000 Z ,
    dateString : '2017-6-19' } ,
  { name : 'Independence Day' ,
    date : 2017 - 07 - 04 T00 : 00 : 00 .000 Z ,
    dateString : '2017-7-4' } ]

Pour déterminer si une date est un jour férié fédéral, utilisez la méthode isAHoliday . Si aucun argument n'est fourni, la date par défaut est la date actuelle :

 const fedHolidays = require ( "@18f/us-federal-holidays" ) ;

const options = {
  shiftSaturdayHolidays : true ,
  shiftSundayHolidays : true ,
  utc : false
} ;
const isAHoliday = fedHolidays . isAHoliday ( myDate , options ) ;
// Returns true or false

Les trois méthodes prennent options comme deuxième argument. Cet argument est un objet simple qui accepte les propriétés suivantes :

 {
  // Whether or not holidays that fall on Saturdays should be
  // shifted to Friday observance. If you don't follow the
  // US federal standard for observing holidays on weekends,
  // you can adjust by setting this value to false.
  // Default value is true.
  shiftSaturdayHolidays : boolean ,

  // Whether or not holidays that fall on Sundays should be
  // shifted to Monday observance. If you don't follow the
  // US federal standard for observing holidays on weekends,
  // you can adjust by setting this value to false.
  // Default value is true.
  shiftSundayHolidays : boolean
}

De plus, isAHoliday prend un paramètre options.utc :

 {
  // Whether to treat the first argument as a UTC date instead
  // of the local time.  Defaults to false.  This is useful if
  // you're generating dates from UTC timestamps or otherwise
  // creating objects from UTC-based dates.
  // Default value is false.
  // This option only applies to the isAHoliday method.
  utc: boolean ;
}

Domaine public

Ce projet est dans le domaine public mondial. Comme indiqué dans CONTRIBUER :

Ce projet est dans le domaine public aux États-Unis, et les droits d'auteur et droits connexes sur l'œuvre dans le monde entier sont renoncés grâce à la dédicace au domaine public universel CC0 1.0.

Toutes les contributions à ce projet seront publiées sous la dédicace CC0. En soumettant une pull request, vous acceptez de vous conformer à cette renonciation aux droits d'auteur.