slovak-holidays

Slovak public holidays

Usage no npm install needed!

<script type="module">
  import slovakHolidays from 'https://cdn.skypack.dev/slovak-holidays';
</script>

README

Slovak public holidays

Slovensky

NPM module which is able to calculate Slovak public holidays since 1993 to the future. It is pure Node.js code without any dependencies.

Usage

npm install slovak-holidays

import {isHoliday, getAllHolidays, getHolidayName} from 'slovak-holidays';

API

isHoliday(date|object): boolean

Calculate if a given date|object is a holiday.

parameter

  • date - instance of Javascript Date object
  • object - holiday object {year: integer, month: integer: day: integer}
isHoliday(new Date(1993, 0, 1)) // => true, Independence day
isHoliday(new Date(1993, 0, 2)) // => false, regular working day
isHoliday(new Date(2019, 3, 19)) // => true, Good Friday

isHoliday({year: 1993, month: 1,  day: 1}) // => true, Independence day
isHoliday({year: 1993, month: 1,  day: 2}) // => false, regular working day
isHoliday({year: 1993, month: 4,  day: 19}) // => true, Good Friday

getAllHolidays(year): array

Returns all holidays for a given year chronologically.

getAllHolidays(1992) // => [], year less than Independence since 1993
getAllHolidays(null) // => [], invalid year
getAllHolidays(2019)
// => [
//  {day: 1, month: 1, year: 2019, name: "Deň vzniku Slovenskej republiky"},
//  {day: 6, month: 1, year: 2019, name: "Zjavenie Pána (Traja králi)"},
//  {day: 19, month: 4, year: 2019, name: "Veľký piatok"},
//  {day: 21, month: 4, year: 2019, name: "Veľkonočná nedeľa"},
//  {day: 22, month: 4, year: 2019, name: "Veľkonočný pondelok"},
//  {day: 1, month: 5, year: 2019, name: "Sviatok práce" },
//  {day: 8, month: 5, year: 2019, name: "Deň víťazstva nad fašizmom"},
//  {day: 5, month: 7, year: 2019, name: "Sviatok svätého Cyrila a Metoda"},
//  {day: 29, month: 8, year: 2019, name: "Výročie SNP"},
//  {day: 1, month: 9, year: 2019, name: "Deň Ústavy Slovenskej republiky"},
//  {day: 15, month: 9, year: 2019, name: "Sedembolestná Panna Mária"},
//  {day: 1, month: 11, year: 2019, name: "Sviatok všetkých svätých"},
//  {day: 17, month: 11, year: 2019, name: "Deň boja za slobodu a demokraciu"},
//  {day: 24, month: 12, year: 2019, name: "Štedrý deň"},
//  {day: 25, month: 12, year: 2019, name: "Prvý sviatok vianočný"},
//  {day: 26, month: 12, year: 2019, name: "Druhý sviatok vianočný"}
// ]

getHolidayName(date|object, locale = 'sk'): string|null

Returns a holiday name for a given date|object if a holiday, otherwise null.

parameter

  • date - instance of Javascript Date object
  • object - holiday object {year: integer, month: integer: day: integer}
  • locale - iso2 string of language to translate a holiday name ('sk', 'en','de' supported)
getHolidayName(new Date(1993, 0, 1)) // => "Deň vzniku Slovenskej republiky"
getHolidayName(new Date(1993, 0, 2)) // => null
getHolidayName(new Date(2019, 3, 19)) // => "Veľký piatok"

getHolidayName(new Date(1993, 0, 1), 'en') // => "Republic Day"
getHolidayName(new Date(1993, 0, 2), 'en') // => null
getHolidayName(new Date(2019, 3, 19), 'en') // => "Good Friday"

getHolidayName({year: 1993, month: 1,  day: 1}) // => "Deň vzniku Slovenskej republiky"
getHolidayName({year: 1993, month: 1,  day: 2}) // => null
getHolidayName({year: 1993, month: 4,  day: 19}) // => "Veľký piatok"