nagerdate
The goal of nagerdate is to create a convenient API wrapper to the Nager.Date API.
The Nager.Date API has an interface for getting holidays for a long list of countries for these holiday variants below:
- Public holidays
- Bank holidays
- School holidays
- Authority holidays
- Optional holidays where most people take a day off
- Observance holidays for optional festivities.
Installation
You can install the development version of nagerdate like so:
remotes::install_github("krose/nagerdate")
Example
This is a basic example which shows you how to solve a common problem:
library(nagerdate)
# Get the suported countries
head(nd_available_countries())
#> # A tibble: 6 x 2
#> countryCode name
#> <chr> <chr>
#> 1 AD Andorra
#> 2 AL Albania
#> 3 AR Argentina
#> 4 AT Austria
#> 5 AU Australia
#> 6 AX Åland Islands
# Get the country info for Germany
head(nd_country_info(country_code = "DE"))
#> # A tibble: 1 x 5
#> commonName officialName countryCode region borders
#> <chr> <chr> <chr> <chr> <list>
#> 1 Germany Federal Republic of Germany DE Europe <df [9 x 5]>
# Get the holidays for Germany in 2023
head(nd_holidays(country_code = "DE", year = 2023))
#> # A tibble: 6 x 9
#> date localName name countryCode fixed global counties launchYear types
#> <chr> <chr> <chr> <chr> <lgl> <lgl> <chr> <int> <chr>
#> 1 2023-01-01 Neujahr New ~ DE TRUE TRUE "" 1967 Publ~
#> 2 2023-01-06 Heilige D~ Epip~ DE TRUE FALSE "DE-BW;~ 1967 Publ~
#> 3 2023-03-08 Internati~ Inte~ DE TRUE FALSE "DE-BE;~ 2019 Publ~
#> 4 2023-04-07 Karfreitag Good~ DE FALSE TRUE "" NA Publ~
#> 5 2023-04-09 Ostersonn~ East~ DE FALSE FALSE "DE-BB;~ NA Publ~
#> 6 2023-04-10 Ostermont~ East~ DE FALSE TRUE "" 1642 Publ~