Skip to contents

Retrieves the list of official public holidays in Peru 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 (Spanish), 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_peru_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 (Spanish)

  • name: Holiday name in English

Examples

get_peru_holidays(2024)
#> # A tibble: 14 × 3
#>    date       local_name                   name                      
#>    <date>     <chr>                        <chr>                     
#>  1 2024-01-01 Año Nuevo                    New Year's Day            
#>  2 2024-03-28 Jueves Santo                 Holy Thursday             
#>  3 2024-03-28 Jueves Santo                 Maundy Thursday           
#>  4 2024-03-29 Viernes Santo                Good Friday               
#>  5 2024-03-31 Domingo Santo                Easter Sunday             
#>  6 2024-05-01 Día del Trabajo              International Workers' Day
#>  7 2024-06-29 Día de San Pedro y San Pablo St. Peter and St. Paul    
#>  8 2024-07-28 Día de la Independencia      Independence Day          
#>  9 2024-07-29 Día de la Independencia      Independence Day          
#> 10 2024-08-30 Día de Santa Rosa de Lima    Santa Rosa de Lima        
#> 11 2024-10-08 Combate de Angamos           Battle of Angamos         
#> 12 2024-11-01 Día de Todos los Santos      All Saints Day            
#> 13 2024-12-08 Inmaculada Concepción        Immaculate Conception     
#> 14 2024-12-25 Navidad                      Christmas Day             
get_peru_holidays(2025)
#> # A tibble: 14 × 3
#>    date       local_name                   name                      
#>    <date>     <chr>                        <chr>                     
#>  1 2025-01-01 Año Nuevo                    New Year's Day            
#>  2 2025-04-17 Jueves Santo                 Holy Thursday             
#>  3 2025-04-17 Jueves Santo                 Maundy Thursday           
#>  4 2025-04-18 Viernes Santo                Good Friday               
#>  5 2025-04-20 Domingo Santo                Easter Sunday             
#>  6 2025-05-01 Día del Trabajo              International Workers' Day
#>  7 2025-06-29 Día de San Pedro y San Pablo St. Peter and St. Paul    
#>  8 2025-07-28 Día de la Independencia      Independence Day          
#>  9 2025-07-29 Día de la Independencia      Independence Day          
#> 10 2025-08-30 Día de Santa Rosa de Lima    Santa Rosa de Lima        
#> 11 2025-10-08 Combate de Angamos           Battle of Angamos         
#> 12 2025-11-01 Día de Todos los Santos      All Saints Day            
#> 13 2025-12-08 Inmaculada Concepción        Immaculate Conception     
#> 14 2025-12-25 Navidad                      Christmas Day