Feiertage.js

Feiertage.js is a small npm module without dependencies to calculate German holidays for each Bundesland.

Installation

yarn: yarn add feiertagejs
npm: npm install feiertagejs
bower: bower install feiertagejs
Plain old Javascript as a download (v1.2.2) - not recommended

This package provides two bundles:

an UMD bundle (default, for Node.js and direct usage in the browser)
ES Modules (automatically picked up by ES module-aware tools like Webpack, Rollup)

Quick Examples

ES Modules

import { getHolidays, isHoliday, isSpecificHoliday } from 'feiertagejs';

const today = new Date();

console.log(isHoliday(today, 'BW'));
// probably false, because you are working ;)

// check if a day is a specific holiday:
console.log(isSpecificHoliday(today, 'CHRISTIHIMMELFAHRT'));

// get all holiday for a single year: getHolidays()
// returns an array of objects [ {name: '', date: ''} ,...]

const holidays2018 = getHolidays('2018','BUND');

console.log('date', holidays2018[0].date); // = Date("2018-01-01");
console.log('name', holidays2018[0].name); // 'NEUJAHRSTAG' (constant) 
console.log('translation', holidays2018[0].trans()); // German translation: Neujahrstag
console.log('equals?', holidays2018[0].equals(date)); // Compare days only (ignore time)

Usage in Node.js

var feiertagejs = require('feiertagejs');

var today = new Date();

console.log(feiertagejs.isHoliday(today, 'BW'));
// probably false, because you are working ;)

// check if a day is a specific holiday:
console.log(feiertagejs.isSpecificHoliday(today, 'CHRISTIHIMMELFAHRT'));

// get all holiday for a single year: getHolidays()
// returns an array of objects [ {name: '', date: ''} ,...]

var holidays2018 = feiertagejs.getHolidays('2018', 'BUND');

console.log('date', holidays2018[0].date); // = Date("2018-01-01");
console.log('name', holidays2018[0].name); // 'NEUJAHRSTAG' (constant)
console.log('translation', holidays2018[0].trans()); // German translation: Neujahrstag
console.log('equals?', holidays2018[0].equals(date)); // Compare days only (ignore time)

API doc

The full API doc can be found here. Note that although the documentation uses custom Flow types (e.g. HolidayType) you are not required to use Flow in your code (see "Usage in Node.js").

Feedback and Questions

You have two options two give feedback:

Open issues or pullrequests on github
Comment the official release post, unfortunately in German.

Contributors

Thank you for contributing:

thetric
SteveOswald

Feedback

If you have any questions, feel free to open an issue.

simonabler/feiertagejs