holidays 라이브러리를 사용하여 특정 년도의 공휴일 날짜를 가져오는 방법에 대해서 알아보겠습니다.

holidays 라이브러리는 아래와 같이 pip로 설치할 수 있습니다.

$ pip install holidays

1. 한국의 공휴일 날짜 가져오기

아래 예제는 한국의 2023년의 모든 공휴일 날짜와 이름을 출력하는 예제입니다.

  • holidays.SouthKorea(years=2023) : 한국의 2023년 공휴일 정보를 가져옴, 2023년 대신에 확인하고 싶은 년도를 인자로 입력하면 됨
  • kr_holidays.items() : 모든 date와 name 정보를 리턴
import holidays

# 대한민국 2023년 공휴일 정보 가져옴
kr_holidays = holidays.SouthKorea(years=2023)

# 모든 공휴일 날짜 출력
for date, name in sorted(kr_holidays.items()):
    print(f"{date}: {name}")

Output:

2023-01-01: New Year's Day
2023-01-21: The day preceding Lunar New Year
2023-01-22: Lunar New Year
2023-01-23: The second day of Lunar New Year
2023-01-24: Alternative holiday for Lunar New Year
2023-03-01: Independence Movement Day
2023-05-05: Children's Day
2023-05-27: Buddha's Birthday
2023-05-29: Alternative holiday for Buddha's Birthday
2023-06-06: Memorial Day
2023-08-15: Liberation Day
2023-09-28: The day preceding Chuseok
2023-09-29: Chuseok
2023-09-30: The second day of Chuseok
2023-10-03: National Foundation Day
2023-10-09: Hangul Day
2023-12-25: Christmas Day

2. 다른 나라의 공휴일 날짜 가져오기

일본 공휴일

import holidays

jp_holidays = holidays.Japan(years=2023)

for date, name in sorted(jp_holidays.items()):
    print(f"{date}: {name}")

Output:

2023-01-01: New Year's Day
2023-01-02: Substitute Holiday
2023-01-09: Coming of Age Day
2023-02-11: Foundation Day
2023-02-23: Emperor's Birthday
2023-03-21: Vernal Equinox Day
2023-04-29: Showa Day
2023-05-03: Constitution Day
2023-05-04: Greenery Day
2023-05-05: Children's Day
2023-07-17: Marine Day
2023-08-11: Mountain Day
2023-09-18: Respect for the Aged Day
2023-09-23: Autumnal Equinox
2023-10-09: Sports Day
2023-11-03: Culture Day
2023-11-23: Labor Thanksgiving Day

미국 공휴일

import holidays

us_holidays = holidays.UnitedStates(years=2023)

for date, name in sorted(us_holidays.items()):
    print(f"{date}: {name}")

Output:

2023-01-01: New Year's Day
2023-01-02: New Year's Day (Observed)
2023-01-16: Martin Luther King Jr. Day
2023-02-20: Washington's Birthday
2023-05-29: Memorial Day
2023-06-19: Juneteenth National Independence Day
2023-07-04: Independence Day
2023-09-04: Labor Day
2023-10-09: Columbus Day
2023-11-10: Veterans Day (Observed)
2023-11-11: Veterans Day
2023-11-23: Thanksgiving
2023-12-25: Christmas Day