Get Official Public Holidays in Japan for a Given Year

Retrieves the list of official public holidays in Japan 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 (Japanese), 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_japan_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 (Japanese)

• name: Holiday name in English

Examples

get_japan_holidays(2024)
#> # A tibble: 16 × 3
#>    date       local_name   name                     
#>    <date>     <chr>        <chr>                    
#>  1 2024-01-01 元日         New Year's Day           
#>  2 2024-01-08 成人の日     Coming of Age Day        
#>  3 2024-02-12 建国記念の日 Foundation Day           
#>  4 2024-02-23 天皇誕生日   The Emperor's Birthday   
#>  5 2024-03-20 春分の日     Vernal Equinox Day       
#>  6 2024-04-29 昭和の日     Shōwa Day                
#>  7 2024-05-03 憲法記念日   Constitution Memorial Day
#>  8 2024-05-04 みどりの日   Greenery Day             
#>  9 2024-05-06 こどもの日   Children's Day           
#> 10 2024-07-15 海の日       Marine Day               
#> 11 2024-08-12 山の日       Mountain Day             
#> 12 2024-09-16 敬老の日     Respect for the Aged Day 
#> 13 2024-09-22 秋分の日     Autumnal Equinox Day     
#> 14 2024-10-14 スポーツの日 Sports Day               
#> 15 2024-11-04 文化の日     Culture Day              
#> 16 2024-11-23 勤労感謝の日 Labour Thanksgiving Day  
get_japan_holidays(2025)
#> # A tibble: 16 × 3
#>    date       local_name   name                     
#>    <date>     <chr>        <chr>                    
#>  1 2025-01-01 元日         New Year's Day           
#>  2 2025-01-13 成人の日     Coming of Age Day        
#>  3 2025-02-11 建国記念の日 Foundation Day           
#>  4 2025-02-24 天皇誕生日   The Emperor's Birthday   
#>  5 2025-03-20 春分の日     Vernal Equinox Day       
#>  6 2025-04-29 昭和の日     Shōwa Day                
#>  7 2025-05-03 憲法記念日   Constitution Memorial Day
#>  8 2025-05-06 みどりの日   Greenery Day             
#>  9 2025-05-05 こどもの日   Children's Day           
#> 10 2025-07-21 海の日       Marine Day               
#> 11 2025-08-11 山の日       Mountain Day             
#> 12 2025-09-15 敬老の日     Respect for the Aged Day 
#> 13 2025-09-23 秋分の日     Autumnal Equinox Day     
#> 14 2025-10-13 スポーツの日 Sports Day               
#> 15 2025-11-03 文化の日     Culture Day              
#> 16 2025-11-24 勤労感謝の日 Labour Thanksgiving Day