kaynoh / holidays-kr

대한민국 공휴일을 가공한 자료

대한민국의 공휴일

다 함께 쉬는 날을 csv, ics, json 파일 형식으로 가공한 자료입니다.

• 구글, 애플 캘린더 등에서 구독할 수 있도록 공개 캘린더 호스팅을 제공합니다.
• 자바스크립트에서 활용할 수 있도록 패키지를 제공합니다. (npm, jsDelivr)

Note 매년 월력요항이 발표된 이후 작업이 이뤄집니다. 지연될 경우 이슈를 남겨주세요.

주요 특징

• 월력요항¹에 게재된 '관공서의 공휴일'을 가공한 자료입니다.
• 공휴일 명칭은 공휴일에 관한 법률을 따릅니다. (예: 기독탄신일)
• 공휴일이 아닌 국경일은 포함하지 않습니다. (예: 제헌절)
• 지방 공휴일은 포함하지 않습니다. (예: 4·3희생자추념일)
• 제공되는 csv 파일은 Google 캘린더와 호환됩니다.
• 제공되는 ics 파일은 iCalendar 표준을 따릅니다.

문제 상황

구글, 애플에서 제공하는 캘린더에는 공휴일이 제대로 표시되지 않습니다.

공식 자료를 바탕으로 만든 공유 캘린더를 구독하면 정상적으로 표시됩니다.

제헌절 (2023년 7월 17일)	쉬는 날 추석 연휴 (2023년 10월 2일)
공휴일이 아니지만 '대한민국의 휴일' 캘린더에 표시됩니다.	2023년 월력요항에 따르면 대체 공휴일이 아닙니다.

석가탄신일 (2023년 5월 26일)
'부처님 오신 날'은 음력 4월 8일로 2023년 5월 27일입니다.

캘린더 구독

https://holidays.hyunbin.page/basic.ics 주소를 구독합니다.

Warning 위 URL을 직접 공유하는 것을 금합니다. holidays.hyunbin.page를 공유합니다.

Note Google 캘린더에서 새로 추가된 공휴일을 불러오는데 24시간 이상 걸릴 수 있습니다.

• Google Calendar 웹: '다른 캘린더' 옆 + > URL로 추가
• Apple iCloud 캘린더: 파일 > 새로운 캘린더 구독

일정 가져오기

다운로드한 파일에 포함된 공휴일 일정을 불러와 등록합니다. 1회성입니다.

• Google Calendar 웹: '다른 캘린더' 옆 + > 가져오기
• Mac 캘린더: 파일 > 가져오기

파일 다운로드

• 연도별 csv, ics, json 파일은 public 폴더에 위치합니다.
• 모든 연도의 정보가 담긴 json, ics 파일도 제공됩니다.

Warning Chromium 웹 브라우저에서는 파일이 .txt 확장자로 저장되지 않도록 주의합니다.

Chrome: 다른 이름으로 링크 저장, Firefox: 링크를 다른 이름으로 저장, Safari: 링크된 파일 다운로드

Footnotes

1. 월력요항은 달력 제작의 기준이 되는 자료입니다. 천문법과 천문법 시행령에 의거해 작성되어 관보에 게재됩니다. ↩