Skip to contents

Retrieves the list of official public holidays in Brazil 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 (Portuguese), 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_brazil_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 (Portuguese)

  • name: Holiday name in English

Examples

get_brazil_holidays(2024)
#> # A tibble: 15 × 3
#>    date       local_name                           name                         
#>    <date>     <chr>                                <chr>                        
#>  1 2024-01-01 Confraternização Universal           New Year's Day               
#>  2 2024-02-12 Carnaval                             Carnival                     
#>  3 2024-02-13 Carnaval                             Carnival                     
#>  4 2024-03-29 Sexta-feira Santa                    Good Friday                  
#>  5 2024-03-31 Domingo de Páscoa                    Easter Sunday                
#>  6 2024-04-21 Dia de Tiradentes                    Tiradentes                   
#>  7 2024-05-01 Dia do Trabalhador                   Labour Day                   
#>  8 2024-05-30 Corpus Christi                       Corpus Christi               
#>  9 2024-07-09 Revolução Constitucionalista de 1932 Constitutionalist Revolution…
#> 10 2024-09-07 Dia da Independência                 Independence Day             
#> 11 2024-10-12 Nossa Senhora Aparecida              Our Lady of Aparecida        
#> 12 2024-11-02 Dia de Finados                       All Souls' Day               
#> 13 2024-11-15 Proclamação da República             Republic Proclamation Day    
#> 14 2024-11-20 Dia da Consciência Negra             Black Awareness Day          
#> 15 2024-12-25 Natal                                Christmas Day                
get_brazil_holidays(2025)
#> # A tibble: 15 × 3
#>    date       local_name                           name                         
#>    <date>     <chr>                                <chr>                        
#>  1 2025-01-01 Confraternização Universal           New Year's Day               
#>  2 2025-03-03 Carnaval                             Carnival                     
#>  3 2025-03-04 Carnaval                             Carnival                     
#>  4 2025-04-18 Sexta-feira Santa                    Good Friday                  
#>  5 2025-04-20 Domingo de Páscoa                    Easter Sunday                
#>  6 2025-04-21 Dia de Tiradentes                    Tiradentes                   
#>  7 2025-05-01 Dia do Trabalhador                   Labour Day                   
#>  8 2025-06-19 Corpus Christi                       Corpus Christi               
#>  9 2025-07-09 Revolução Constitucionalista de 1932 Constitutionalist Revolution…
#> 10 2025-09-07 Dia da Independência                 Independence Day             
#> 11 2025-10-12 Nossa Senhora Aparecida              Our Lady of Aparecida        
#> 12 2025-11-02 Dia de Finados                       All Souls' Day               
#> 13 2025-11-15 Proclamação da República             Republic Proclamation Day    
#> 14 2025-11-20 Dia da Consciência Negra             Black Awareness Day          
#> 15 2025-12-25 Natal                                Christmas Day