feiertage

Tiny, simple and pure module to calculate the german non-business days.

How To Use

Simply download the package or install it from npm with npm install feiertage.

var feiertage = require('feiertage');

// full list of all functions to retrieve the date for a specific non-business day of the current year
feiertage.Neujahr();
feiertage.HeiligeDreiKoenige();
feiertage.Karfreitag();
feiertage.Ostersonntag();
feiertage.Ostermontag();
feiertage.TagDerArbeit();
feiertage.ChristiHimmelfahrt();
feiertage.Pfingstsonntag();
feiertage.Pfingstmontag();
feiertage.Fronleichnam();
feiertage.MariaHimmelfahrt();
feiertage.TagDerDeutschenEinheit();
feiertage.Reformationstag();
feiertage.Allerheiligen();
feiertage.BußUndBettag();
feiertage.Heiligabend();
feiertage.ErsterWeihnachtsfeiertag();
feiertage.ZweiterWeihnachtsfeiertag();
feiertage.Silvester();

// every function accepts a year as a parameter
feiertage.Neujahr(2019);
feiertage.HeiligeDreiKoenige(2020);
...

// non-business days for the current year as a list of objects
// every objects has the properties id, label, date
feiertage.asList();

// non-business days for a given year as a list of objects
feiertage.asList(2020);
feiertage.asList(2021);

// asList also accepts a german state code, like BY, BE, SH or TH, so it returns only non-business days valid for these german states
feiertage.asList(2020, 'BY');
feiertage.asList(2021, 'BE');

// returns only non-business days falling on monday to friday
feiertage.asListOfWorkdays(2016, 'BY');

A list of the supported german state codes. There are five additional codes to specify special regulations for Friedensfest, Mariä Himmelfahrt and Fronleichnam. The code DE summarizes all german non-business days.

| Code | Description | | ----- | -------------------------------------------------------------------------------------- | | DE | Deutschland (all known non-business days) | | BW | Baden-Württemberg | | BY | Bayern | | BE | Berlin | | BB | Brandenburg | | HB | Bremen | | HH | Hamburg | | HE | Hessen | | NI | Niedersachsen | | MV | Mecklenburg-Vorpommern | | NW | Nordrhein-Westfalen | | RP | Rheinland-Pfalz | | SL | Saarland | | SN | Sachsen | | ST | Sachsen-Anhalt | | SH | Schleswig-Holstein | | TH | Thüringen | | BY-FF | Bayern, Friedensfest, Augsburg only | | BY-MH | Bayern, Mariä Himmelfahrt, predominantly catholic population | | SN-FL | Sachsen, Fronleichnam, some communities in Bautzen | | TH-FL | Thüringen, Fronleichnam, some communities in Eichsfeld, Unstrut-Hainich, Wartburgkreis |

Changelog

1.2.0

• Added special state codes for BY-FF, BY-MH, SN-FL and TH-FL covering the special rules for non-business days, that are only valid in some communities, like Friedensfest, Mariä-Himmelfahrt and Fronleichnam.

1.1.2

• The calculation of easter sunday is now based on the corrected Gauss formula by Lichtenberg

1.1.1

• asListofWorkdays() (new) returns only those non-business days, that fall on monday to friday

1.1.0

• setYear() was removed from the API
• asList() now accepts a state code as second parameter, e.g. BY, BE, SH or TH
• asList() now returns a list of objects instead of an object