본문으로 건너뛰기

공휴일·영업일

주말은 달력으로 바로 답하고, 공휴일은 한국천문연구원 특일 정보로 확인한다. N영업일 뒤 날짜를 계산한다

npm install @duolabs-deux/unit-holidays

직접 넣어 보기

환경변수

이름설명
DATA_GO_KR_SERVICE_KEY필수공공데이터포털 일반 인증키(Decoding). 「한국천문연구원_특일 정보」 활용신청이 필요하다. 계정 하나에 키 하나라 다른 공공데이터 유닛과 같은 키를 쓴다

어댑터

id종류설명
kasi실제한국천문연구원 공휴일 조회(getRestDeInfo). 한 해를 한 번에 받는다
fake가짜양력 고정 공휴일 8개만 안다. 설·추석·대체·임시공휴일이 없다

실패와 소비 앱이 할 일

종류언제할 일
invalid-input읽을 수 없거나 없는 날짜, 영업일 수가 ±366 을 넘을 때입력 칸에서 바로 알린다
auth키가 없거나, 이 API 활용신청을 안 했을 때(결과 코드 20·30·31·32, HTTP 401·403)운영자에게 알린다
quota하루 호출 한도를 넘었을 때(결과 코드 22)캐시가 한 해 치를 하루 동안 두므로 보통 걸리지 않는다
timeout5초 안에 답이 없을 때(1회 재시도 뒤)주말 판정은 여전히 된다. 평일 판정만 보류한다
upstream-down천문연구원·포털 서버 오류timeout 과 같다
unexpected응답에 header 가 없거나 형식이 다를 때명세가 바뀌었는지 사람이 본다

한도

  • 개발계정 하루 10,000건(공공데이터포털 안내)
  • 다음다음 해 자료는 보통 그해 여름에 올라온다
  • 임시공휴일은 지정 뒤 하루 안에 반영된다고 안내돼 있다

명세