us federal holidays

US-Bundesfeiertage

Erstellt eine Liste aller US-Bundesfeiertage für ein bestimmtes Jahr und gibt sie zurück. Außerdem wird eine Hilfsmethode zur Bestimmung bereitgestellt, ob ein bestimmtes Datum ein US-Bundesfeiertag ist. Behandelt die Verschiebung von Feiertagen auf den nächsten Wochentag, wenn der Feiertag auf ein Wochenende fällt.

Die bundesstaatlichen Feiertage in den USA entsprechen der Definition von OPM.

Installation

 npm install @18f/us-federal-holidays

Erfordert Node.js 12 oder höher.

Verwendung

Um eine Liste aller US-Bundesfeiertage in einem bestimmten Jahr zu erhalten, verwenden Sie die Methode allForYear . Wenn kein Jahr übergeben wird, wird das aktuelle Jahr verwendet.

 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' } ]

Um eine Liste aller US-Bundesfeiertage innerhalb eines Datumsbereichs zu erhalten, verwenden Sie die inRange -Methode. Wenn kein start angegeben ist, wird das aktuelle Datum verwendet. Wenn das Enddatum weggelassen wird, wird ein Jahr ab dem aktuellen Datum verwendet.

 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' } ]

Um festzustellen, ob es sich bei einem Datum um einen bundesstaatlichen Feiertag handelt, verwenden Sie die Methode isAHoliday . Wenn kein Argument angegeben wird, wird standardmäßig das aktuelle Datum verwendet:

 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

Alle drei Methoden verwenden options als zweites Argument. Dieses Argument ist ein einfaches Objekt, das die folgenden Eigenschaften akzeptiert:

 {
  // 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
}

Darüber hinaus akzeptiert isAHoliday einen options.utc Parameter:

 {
  // 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 ;
}

Public Domain

Dieses Projekt ist weltweit gemeinfrei. Wie unter „Beitrag beitragen“ angegeben:

Dieses Projekt ist in den Vereinigten Staaten gemeinfrei, und Urheberrechte und verwandte Rechte an dem Werk weltweit werden durch die gemeinfreie Widmung CC0 1.0 Universal aufgehoben.

Alle Beiträge zu diesem Projekt werden unter der CC0-Widmung veröffentlicht. Durch das Absenden einer Pull-Anfrage erklären Sie sich damit einverstanden, diesem Verzicht auf Urheberrechtsinteressen nachzukommen.