응답에 포함된 항목
BR, US 및 JP을/를 입력하고 반환된 필드로 알맞은 레코드를 찾으세요.
확인할 필드
- 날짜
- 현지 명칭
- 적용 범위
- 공휴일 유형
Nager.Date Holidays
날짜 · 현지 명칭 · 적용 범위 · 공휴일 유형
라이브 조회
실제 검색어를 입력하고 카드 결과를 확인한 뒤 전체 출처를 열어 보세요.
빠른 예시
국가와 연도가 조회할 달력을 정합니다
공휴일 요청에는 국가 코드가 쓰이며 연간 엔드포인트에서는 연도도 필요합니다. 각 항목에는 date, localName, name, countryCode가 포함됩니다. date는 YYYY-MM-DD 형식이고 localName은 해당 국가에서 쓰는 이름을 보존하며 name은 다른 표기일 수 있습니다. 같은 기념일도 장소에 따라 이름이나 날짜가 달라질 수 있으니 비교 전에 국가와 연도를 정하세요.
- BR, US, JP처럼 두 글자 국가 코드를 사용하세요.
- 국제 일정표를 만들 때는 countryCode를 날짜와 함께 보관하세요.
- 지역 맥락이 중요하다면 localName을 표시하세요.
적용 범위와 유형은 신중히 읽어야 합니다
global, counties, types는 항목의 적용 범위를 해석하는 데 도움이 됩니다. 공휴일이 국가 전체에 적용되지 않거나 counties에 지역 범위가 표시될 수 있습니다. types는 원천의 분류일 뿐 법규, 근로 계약, 학사 일정, 지역 당국 공지 확인을 대신하지 않습니다. 조회를 정리하는 데 쓰고 의무를 단정하는 데 쓰지 마세요.
- 날짜를 전국 공통으로 보기 전에 counties를 확인하세요.
- types는 원천이 제공한 분류로 표시하세요.
- 공식 판단에는 관련 지역이나 기관의 달력을 확인하세요.
미래 날짜는 다시 조회해야 합니다
API는 연간 목록과 다음 공휴일 경로를 제공합니다. fixed와 launchYear는 일부 결과의 메타데이터이지만 반환 집합은 요청한 국가와 기간에 계속 연결됩니다. 일정이 미래 날짜에 의존한다면 사용 시점에 가까워졌을 때 다시 조회하고 데이터 획득 시점을 기록하세요. 오래된 목록을 다른 연도나 장소에 재사용하는 일을 막을 수 있습니다.
- 정해진 기간 계획에는 연간 목록을 사용하세요.
- 짧고 최신인 보기는 다음 공휴일을 사용하세요.
- 달력을 게시할 때 연도, 국가, 조회 시점을 기록하세요.
