us federal holidays

미국 연방 공휴일

특정 연도의 모든 미국 연방 공휴일 목록을 작성 및 반환하고, 특정 날짜가 미국 연방 공휴일인지 확인하는 도우미 메서드를 제공합니다. 공휴일이 주말인 경우 공휴일을 가장 가까운 평일로 변경합니다.

미국 연방 공휴일은 OPM에 의해 정의됩니다.

설치

 npm install @18f/us-federal-holidays

Node.js 12 이상이 필요합니다.

용법

특정 연도의 모든 미국 연방 공휴일 목록을 얻으려면 allForYear 메서드를 사용하세요. 연도가 전달되지 않은 경우 현재 연도를 사용합니다.

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

특정 날짜 범위 내의 모든 미국 연방 공휴일 목록을 얻으려면 inRange 메서드를 사용하세요. start 날짜가 제공되지 않으면 현재 날짜를 사용합니다. 종료 날짜를 생략하면 현재 날짜로부터 1년이 사용됩니다.

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

날짜가 연방 공휴일인지 확인하려면 isAHoliday 메서드를 사용하세요. 인수가 제공되지 않으면 기본값은 현재 날짜입니다.

 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

세 가지 방법 모두 options 두 번째 인수로 사용합니다. 이 인수는 다음 속성을 허용하는 일반 개체입니다.

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

또한 isAHoliday 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 ;
}

공개 도메인

이 프로젝트는 전세계 공개 도메인에 있습니다. 기여에 명시된 대로:

이 프로젝트는 미국 내 퍼블릭 도메인에 있으며, CC0 1.0 Universal 퍼블릭 도메인 헌납을 통해 전 세계 저작물에 대한 저작권 및 관련 권리가 면제됩니다.

이 프로젝트에 대한 모든 기여는 CC0 헌정에 따라 공개됩니다. 끌어오기 요청을 제출함으로써 귀하는 저작권 이익 포기를 준수하는 데 동의하는 것입니다.