대한민국의 공휴일

과학기술정보통신부에서 발표한 월력요항¹을 csv, json, ics 형식으로 가공한 자료입니다.

제작 동기

• 애플 캘린더 등 - 대체 공휴일 일정 미제공
• 구글 캘린더 등 - 잘못된 공휴일 정보 제공
• 공공 데이터 포털 - XML만 제공, API 키 강제²

제공 형식

• 캘린더 구독 - 구글³, 애플⁴ 캘린더 등 지원
• 텍스트 파일 - 웹 호스팅 제공, 다운로드 지원
• 자바스크립트 패키지 - ESM 및 CJS 지원

주요 특징

• 명칭은 공휴일에 관한 법률을 따릅니다. (기독탄신일 등)
• 공휴일이 아닌 국경일은 포함하지 않습니다. (제헌절 등)
• 지방 공휴일은 포함하지 않습니다. (4·3희생자추념일 등)
• 제공되는 csv 파일은 Google 캘린더 형식을 따릅니다.
• 제공되는 ics 파일은 iCalendar 표준을 따릅니다.

공유 캘린더

https://holidays.hyunbin.page/basic.ics 주소로 새로운 캘린더를 구독합니다.

텍스트 파일

생성된 모든 텍스트 파일은 public 디렉터리에 위치합니다.

./public
├── basic.ics   # 모든 연도 (2022년~)
├── basic.json  # 모든 연도 (2022년~)
├── 2022.csv    # 특정 연도
├── 2022.ics    # 특정 연도
├── 2022.json   # 특정 연도
├── 2023.csv
├── 2023.ics
├── 2023.json
└── (하략)

위 파일들은 holidays.hyunbin.page에 게시되어 있습니다.

# (예시) 다음 파일은
./public/basic.json

# 다음 URL에서 확인할 수 있습니다.
https://holidays.hyunbin.page/basic.json