Holidays-kr-ts NPM

holidays-KR-TS

대체공휴일 포함 공휴일 계산기

inspired by python-holidays

Usage

yarn add holidays-kr-ts import getHolidays from 'holidays-kr-ts'

const holidays = getHolidays() // current year in default

Background

API 호출 없이 간단히 공휴일을 계산할 수 있는 유틸 함수가 필요해서 작업한 패키지입니다.

API를 호출하지 않으려 했던 이유는 다음과 같습니다:

python-holidays와 같이, 다른 언어에는 API 호출 없이 공휴일 목록을 불러올 수 있는 패키지가 존재합니다. 물론 API를 사용하지 않는 경우, 정책에 따른 공휴일 확대/축소 및 대체공휴일 적용 방침의 변화에 수기로 대응해주어야 한다는 불편함이 있습니다. 하지만 이러한 정책 변화는 잦지 않습니다. 굳이 API로 불러올 필요가 없는, 즉 계산이 필요 없는 양력 공휴일(날짜 고정)역시 다수 있습니다. 따라서 음력 공휴일(구정, 부처님 오신 날, 추석)의 100년 치 데이터를 직접 갖고, 공휴일 / 대체공휴일 방침을 로직으로 작성한다면 API를 호출하지 않아도 공휴일 목록을 만들어낼 수 있습니다. 음력 날짜 데이터와, 공휴일 계산 로직은 python-holidays의 데이터 및 방식을 따랐습니다.