holidays.countries.south_korea

Classes

KOR(*args, **kwargs)

param years:

KR(*args, **kwargs)

param years:

Korea(*args, **kwargs)

param years:

SouthKorea(*args, **kwargs)

References:

SouthKoreaLunisolarHolidays()

SouthKoreaStaticHolidays()

References:
class holidays.countries.south_korea.SouthKorea(*args, **kwargs)

Bases: ObservedHolidayBase, ChineseCalendarHolidays, ChristianHolidays, InternationalHolidays, StaticHolidays

References:
Checked With:
According to (3), the alt holidays in Korea are as follows:

  • The alt holiday means next first non holiday after the holiday.

  • Independence Movement Day, Liberation Day, National Foundation Day,

    Hangul Day, Children’s Day, Birthday of the Buddha, Christmas Day have alt holiday if they fell on Saturday or Sunday.

  • Korean New Year’s Day, Korean Mid Autumn Day have alt holiday if they

    fell on Sunday.

The alt holidays in Korea are as follows:

  • The alt holiday means next first non holiday after the holiday.

  • Independence Movement Day, Liberation Day, National Foundation Day,

    Hangul Day, Children’s Day, Birthday of the Buddha, Christmas Day have alt holiday if they fell on Saturday or Sunday.

  • Lunar New Year’s Day, Korean Mid Autumn Day have alt holiday if they

    fell on Sunday.

Parameters:

  • years – The year(s) to pre-calculate public holidays for at instantiation.

  • expand – Whether the entire year is calculated when one date from that year is requested.

  • observed – Whether to include the dates when public holiday are observed (e.g. a holiday falling on a Sunday being observed the following Monday). This doesn’t work for all countries.

  • subdiv – The subdivision (e.g. state or province) as a ISO 3166-2 code or its alias; not implemented for all countries (see documentation).

  • prov – deprecated use subdiv instead.

  • state – deprecated use subdiv instead.

  • language – The language which the returned holiday names will be translated into. It must be an ISO 639-1 (2-letter) language code. If the language translation is not supported the original holiday names will be used.

  • categories – Requested holiday categories.

Returns:

A HolidayBase object matching the country.

country: str = 'KR'

The country’s ISO 3166-1 alpha-2 code.

supported_categories: Tuple[str, ...] = ('bank', 'public')

All holiday categories supported by this entity.

default_language: str | None = 'ko'

The entity language used by default.

observed_label = '%s 대체 휴일'
supported_languages: Tuple[str, ...] = ('en_US', 'ko', 'th')

All languages supported by this entity.

class holidays.countries.south_korea.Korea(*args, **kwargs)

Bases: SouthKorea

Parameters:

  • years – The year(s) to pre-calculate public holidays for at instantiation.

  • expand – Whether the entire year is calculated when one date from that year is requested.

  • observed – Whether to include the dates when public holiday are observed (e.g. a holiday falling on a Sunday being observed the following Monday). This doesn’t work for all countries.

  • subdiv – The subdivision (e.g. state or province) as a ISO 3166-2 code or its alias; not implemented for all countries (see documentation).

  • prov – deprecated use subdiv instead.

  • state – deprecated use subdiv instead.

  • language – The language which the returned holiday names will be translated into. It must be an ISO 639-1 (2-letter) language code. If the language translation is not supported the original holiday names will be used.

  • categories – Requested holiday categories.

Returns:

A HolidayBase object matching the country.

class holidays.countries.south_korea.KR(*args, **kwargs)

Bases: SouthKorea

Parameters:

  • years – The year(s) to pre-calculate public holidays for at instantiation.

  • expand – Whether the entire year is calculated when one date from that year is requested.

  • observed – Whether to include the dates when public holiday are observed (e.g. a holiday falling on a Sunday being observed the following Monday). This doesn’t work for all countries.

  • subdiv – The subdivision (e.g. state or province) as a ISO 3166-2 code or its alias; not implemented for all countries (see documentation).

  • prov – deprecated use subdiv instead.

  • state – deprecated use subdiv instead.

  • language – The language which the returned holiday names will be translated into. It must be an ISO 639-1 (2-letter) language code. If the language translation is not supported the original holiday names will be used.

  • categories – Requested holiday categories.

Returns:

A HolidayBase object matching the country.

class holidays.countries.south_korea.KOR(*args, **kwargs)

Bases: SouthKorea

Parameters:

  • years – The year(s) to pre-calculate public holidays for at instantiation.

  • expand – Whether the entire year is calculated when one date from that year is requested.

  • observed – Whether to include the dates when public holiday are observed (e.g. a holiday falling on a Sunday being observed the following Monday). This doesn’t work for all countries.

  • subdiv – The subdivision (e.g. state or province) as a ISO 3166-2 code or its alias; not implemented for all countries (see documentation).

  • prov – deprecated use subdiv instead.

  • state – deprecated use subdiv instead.

  • language – The language which the returned holiday names will be translated into. It must be an ISO 639-1 (2-letter) language code. If the language translation is not supported the original holiday names will be used.

  • categories – Requested holiday categories.

Returns:

A HolidayBase object matching the country.

class holidays.countries.south_korea.SouthKoreaLunisolarHolidays

Bases: _CustomChineseHolidays

BUDDHA_BIRTHDAY_DATES_CUSTOM_CALENDAR = {1931: (5, 25), 1968: (5, 5), 2001: (5, 1), 2012: (5, 28), 2023: (5, 27), 2025: (5, 5)}
LUNAR_NEW_YEAR_DATES_CUSTOM_CALENDAR = {1916: (2, 4), 1944: (1, 26), 1954: (2, 4), 1958: (2, 19), 1966: (1, 22), 1988: (2, 18), 1997: (2, 8), 2027: (2, 7), 2028: (1, 27)}
MID_AUTUMN_DATES_CUSTOM_CALENDAR = {1942: (9, 25), 2040: (9, 21)}
class holidays.countries.south_korea.SouthKoreaStaticHolidays

Bases: object

References:

  1. Election Dates featured here are the ones prior to the proper recodification to Article 34 of the Public Official Election Act(September 2006)

  2. Sabang Day (사방의 날) was technically in the Public Holidays Act itself, but since it was only celebrated in 1960, this is being put here.

national_assembly_election_day = '국회의원 선거일'
presidential_election_day = '대통령 선거일'
local_election_day = '지방선거일'
temporary_public_holiday = '임시공휴일'
presidential_inauguration_day = '대통령 취임식'
national_conference_for_unification_election_day = '통일주체국민회의 선거일'
yushin_constitution_referendum_day = '유신헌법 국민투표일'
may_16_coup_anniversary = '5.16 군사혁명 기념일'
apr_19_revolution_anniversary = '4.19 혁명 기념일'
syngman_rhee_birthday = '이승만 대통령 탄신일'
armed_forces_day = '국군의 날'
special_public_holidays = {1948: ((5, 10, '국회의원 선거일'), (7, 20, '대통령 선거일'), (12, 15, '국제연합의 대한민국 정부 승인 경축 국민대회')), 1949: ((5, 10, '5.10 제헌의회선거 1주년 기념일'), (7, 5, '백범 김구 선생 국민장 영결식')), 1950: ((5, 30, '국회의원 선거일'), (6, 21, '전몰군인 합동위령제')), 1951: ((5, 16, '부통령 선거일'),), 1952: ((4, 25, '지방선거일'), (5, 10, '지방선거일'), (8, 5, '대통령 선거일')), 1954: ((5, 20, '국회의원 선거일'),), 1956: ((5, 15, '대통령 선거일'), (8, 8, '지방선거일'), (8, 13, '지방선거일')), 1957: (3, 26, '이승만 대통령 탄신일'), 1958: ((5, 2, '국회의원 선거일'), (3, 26, '이승만 대통령 탄신일')), 1959: (3, 26, '이승만 대통령 탄신일'), 1960: ((3, 16, '사방의 날'), (3, 26, '이승만 대통령 탄신일'), (3, 15, '대통령 선거일'), (7, 29, '국회의원 선거일'), (8, 12, '대통령 선거일'), (10, 1, '신정부 경축의 날'), (12, 12, '지방선거일'), (12, 19, '지방선거일'), (12, 26, '지방선거일'), (12, 29, '지방선거일')), 1961: (4, 19, '4.19 혁명 기념일'), 1962: ((4, 19, '4.19 혁명 기념일'), (5, 16, '5.16 군사혁명 기념일')), 1963: ((4, 19, '4.19 혁명 기념일'), (5, 16, '5.16 군사혁명 기념일'), (10, 15, '대통령 선거일'), (11, 26, '국회의원 선거일'), (12, 17, '대통령 취임식')), 1966: (10, 1, '국군의 날'), 1967: ((1, 4, '임시공휴일'), (5, 3, '대통령 선거일'), (6, 8, '국회의원 선거일'), (7, 1, '대통령 취임식')), 1969: ((7, 21, '아폴로 11호 달 착륙 기념'), (10, 17, '삼선 헌법 개정 국민투표일')), 1971: ((4, 27, '대통령 선거일'), (5, 25, '국회의원 선거일'), (7, 1, '대통령 취임식')), 1972: ((11, 21, '유신헌법 국민투표일'), (12, 15, '통일주체국민회의 선거일'), (12, 23, '대통령 선거일'), (12, 27, '대통령 취임식')), 1973: (2, 27, '국회의원 선거일'), 1974: (8, 19, '대통령 영부인 육영수 여사 국민장 영결식'), 1975: (2, 12, '유신헌법 국민투표일'), 1978: ((5, 18, '통일주체국민회의 선거일'), (7, 6, '대통령 선거일'), (12, 12, '국회의원 선거일'), (12, 27, '대통령 취임식')), 1979: ((11, 3, '박정희 대통령 국장 영결식'), (12, 6, '대통령 선거일'), (12, 21, '대통령 취임식')), 1980: ((8, 27, '대통령 선거일'), (9, 1, '대통령 취임식'), (10, 22, '제5공화국 헌법 개정 국민투표일')), 1981: ((2, 11, '선거를 위한 선거인단 선일'), (2, 25, '대통령 선거일'), (3, 3, '대통령 취임식'), (3, 25, '국회의원 선거일')), 1982: (10, 2, '임시공휴일'), 1985: (2, 12, '국회의원 선거일'), 1987: ((12, 16, '대통령 선거일'), (10, 27, '제6공화국 헌법 개정 국민투표일')), 1988: ((2, 25, '대통령 취임식'), (4, 26, '국회의원 선거일'), (9, 17, '1988 서울 올림픽 개막식')), 1991: ((3, 26, '지방선거일'), (6, 20, '지방선거일')), 1992: ((3, 24, '국회의원 선거일'), (12, 18, '대통령 선거일')), 1995: (6, 27, '지방선거일'), 1996: (4, 11, '국회의원 선거일'), 1997: (12, 18, '대통령 선거일'), 1998: (6, 4, '지방선거일'), 2000: (4, 13, '국회의원 선거일'), 2002: ((6, 13, '지방선거일'), (7, 1, '2002년 한일 월드컵 대표팀 4강 진출'), (12, 19, '대통령 선거일')), 2004: (4, 15, '국회의원 선거일'), 2006: (5, 31, '지방선거일'), 2015: (8, 14, '임시공휴일'), 2016: (5, 6, '임시공휴일'), 2017: ((5, 9, '대통령 선거일'), (10, 2, '임시공휴일')), 2020: (8, 17, '임시공휴일'), 2023: (10, 2, '임시공휴일')}
special_public_holidays_observed = {1959: (4, 6, '식목일'), 1960: ((7, 18, '제헌절'), (10, 10, '한글날'), (12, 26, '기독탄신일')), 1989: (10, 2, '국군의 날')}