Nager.Date

Nager.Date로 국가와 연도별 공휴일을 조회하고, 전국 대상인지 지역 대상인지 확인해 일정표를 만드는 출발점으로 활용할 수 있습니다.

공식 문서

현재 공개 응답

Nager.Date에서 응답을 불러옵니다. 검색어를 입력할 필요가 없습니다.

응답에 포함된 항목

Nager.Date로 국가와 연도별 공휴일을 조회하고, 전국 대상인지 지역 대상인지 확인해 일정표를 만드는 출발점으로 활용할 수 있습니다.

목록에 전국 공휴일로 표시되어도 특정 도시의 은행, 학교, 상점, 배송 또는 관공서 운영 시간을 바로 판단할 수는 없습니다. 마감일, 휴가, 결제 또는 서비스 시간을 안내하기 전에 subdivisionCodes, holidayTypes 및 담당 기관의 공식 안내를 확인하세요.

확인할 필드

ISO 형식 날짜
공휴일 이름
전국 또는 지역 적용 범위
공휴일 유형

연간 조회가 돌려주는 내용

Holidays 경로는 국가와 연도를 경로에 넣습니다. BR과 2026의 경우 확인한 응답은 객체 목록입니다. 각 객체에는 YYYY-MM-DD 형식의 date, name, countryCode, nationalHoliday, subdivisionCodes, holidayTypes가 들어 있습니다. 모든 공휴일이 국가 전체에 적용되는 것은 아니므로 모두가 쉬는 날로 표시하기 전에 적용 범위를 읽어야 합니다.

countryCode는 조회한 국가 코드이며 도시를 뜻하지 않습니다.
nationalHoliday와 subdivisionCodes를 함께 읽으세요. 날짜가 특정 지역에만 적용될 수 있습니다.
holidayTypes는 분류이며 지역 영업시간을 확정하는 정보가 아닙니다.

유용한 요청을 만드는 방법

먼저 두 글자 ISO 국가 코드를 고르고, 그다음 계획할 연도를 선택하세요. 이 페이지는 연간 응답에서 필드를 한 목록 안에서 비교할 수 있어 BR과 2026을 보여 줍니다. 팀 일정표에서는 모든 항목을 전국 휴일로 바꾸지 말고 날짜와 적용 범위를 따로 저장하세요.

서로 다른 기간의 달력이 섞이지 않도록 URL에 연도를 명시하세요.
다른 프로젝트에서 응답을 재사용하기 전에 국가 코드가 맞는지 확인하세요.
고려해야 할 장소나 규칙에 해당하는 날짜만 정렬하고 눈에 띄게 표시하세요.

마감일에 쓰기 전 주의

공휴일 목록은 계획에 유용하지만 서비스 운영, 은행 결제, 배송, 수업 또는 법적 의무를 혼자 결정하지는 못합니다. 적용 범위는 도시, 기관, 활동에 따라 달라질 수 있습니다. 날짜가 금전, 계약, 공적 마감일 또는 여행에 영향을 준다면 담당 기관, 회사 또는 서비스에서 규칙을 확인하세요.

반환 필드를 확인하지 않고 지역 날짜를 전국 휴무로 안내하지 마세요.
API만으로 법정 마감일을 계산하지 마세요.
특정 시간이나 의무에 따라 판단할 때는 확인한 공식 출처를 기록하세요.