Skip to contents

Retrieves the list of official public holidays in South Korea for a specific year using the Nager.Date public holidays API. This function returns a tibble containing the date of the holiday, the name in the local language (Korean), and the English name. It is useful for academic, planning, and data analysis purposes. The information is retrieved directly from the Nager.Date API and reflects the current status of holidays for the requested year. The field names returned are consistent with the API structure.

Usage

get_southkorea_holidays(year)

Source

Data obtained from the Nager.Date API: https://date.nager.at/

Arguments

year

An integer indicating the year (e.g., 2024 or 2025).

Value

A tibble with the following columns:

  • date: Date of the holiday (class Date)

  • local_name: Holiday name in the local language (Korean)

  • name: Holiday name in English

Examples

get_southkorea_holidays(2024)
#> # A tibble: 15 × 3
#>    date       local_name     name                     
#>    <date>     <chr>          <chr>                    
#>  1 2024-01-01 새해           New Year's Day           
#>  2 2024-02-09 설날           Lunar New Year           
#>  3 2024-02-10 설날           Lunar New Year           
#>  4 2024-02-12 설날           Lunar New Year           
#>  5 2024-03-01 3·1절          Independence Movement Day
#>  6 2024-05-06 어린이날       Children's Day           
#>  7 2024-05-15 부처님 오신 날 Buddha's Birthday        
#>  8 2024-06-06 현충일         Memorial Day             
#>  9 2024-08-15 광복절         Liberation Day           
#> 10 2024-09-16 추석           Chuseok                  
#> 11 2024-09-17 추석           Chuseok                  
#> 12 2024-09-18 추석           Chuseok                  
#> 13 2024-10-03 개천절         National Foundation Day  
#> 14 2024-10-09 한글날         Hangul Day               
#> 15 2024-12-25 크리스마스     Christmas Day            
get_southkorea_holidays(2025)
#> # A tibble: 15 × 3
#>    date       local_name     name                     
#>    <date>     <chr>          <chr>                    
#>  1 2025-01-01 새해           New Year's Day           
#>  2 2025-01-28 설날           Lunar New Year           
#>  3 2025-01-29 설날           Lunar New Year           
#>  4 2025-01-30 설날           Lunar New Year           
#>  5 2025-03-01 3·1절          Independence Movement Day
#>  6 2025-05-05 어린이날       Children's Day           
#>  7 2025-05-05 부처님 오신 날 Buddha's Birthday        
#>  8 2025-06-06 현충일         Memorial Day             
#>  9 2025-08-15 광복절         Liberation Day           
#> 10 2025-10-03 개천절         National Foundation Day  
#> 11 2025-10-06 추석           Chuseok                  
#> 12 2025-10-07 추석           Chuseok                  
#> 13 2025-10-08 추석           Chuseok                  
#> 14 2025-10-09 한글날         Hangul Day               
#> 15 2025-12-25 크리스마스     Christmas Day