Open Source

Feiertage.js

Deutsche Feiertage für Node.js & Browser JavaScript

Ein leichtgewichtiges TypeScript npm Modul zur Berechnung deutscher Feiertage für jedes Bundesland – ohne Abhängigkeiten.

Auf npm ansehen GitHub Repository

npm install feiertagejs

Installation

Installieren Sie Feiertage.js mit Ihrem bevorzugten Package Manager:

npm

npm install feiertagejs

yarn

Yarn

yarn add feiertagejs

pnpm

pnpm add feiertagejs

Schnellstart

So einfach ist die Verwendung von Feiertage.js:

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

// Ist heute ein Feiertag in Bayern?
const today = new Date();
const isTodayHoliday = isHoliday(today, 'BY');

// Alle Feiertage 2026 für Bayern
const holidays2026 = getHolidays('2026', 'BY');

// Ist Christi Himmelfahrt?
const isAscension = isSpecificHoliday(
  today, 'CHRISTIHIMMELFAHRT', 'ALL'
);

dayjs Plugin: dayjs-feiertage

Für Projekte mit dayjs gibt es ein passendes Plugin: dayjs-feiertage. Es basiert auf Feiertage.js und ergänzt dayjs um Holiday-Checks und Jahreslisten.

Auf npm ansehen

Installation

pnpm

pnpm add dayjs-feiertage dayjs

npm

npm install dayjs-feiertage dayjs

yarn

yarn add dayjs-feiertage dayjs

Quick Start

import dayjs from "dayjs";
import dayjsFeiertage from "dayjs-feiertage";

// Extend dayjs with the plugin
dayjs.extend(dayjsFeiertage);

// Check if a date is a holiday
dayjs("2025-12-25").isHoliday("BUND"); // true

// Check if a date is a Sunday or holiday
dayjs("2025-12-25").isSunOrHoliday("BUND"); // true

// Get all holidays for a year
dayjs("2025-01-01").getHolidaysOfYear("BY"); // Holiday[]

Praxisbeispiele

Ist heute ein Feiertag?

Prüfen Sie, ob ein bestimmtes Datum ein Feiertag in einem Bundesland ist.

import { isHoliday } from 'feiertagejs';

const date = new Date('2026-12-25');
isHoliday(date, 'BW');
// => true

Alle Feiertage eines Jahres

Erhalten Sie alle Feiertage für ein Jahr und eine Region.

import { getHolidays } from 'feiertagejs';

const holidays = getHolidays('2026', 'BY');

holidays[0].name;
// => 'NEUJAHRSTAG'

holidays[0].translate('de');
// => 'Neujahrstag'

Spezifischen Feiertag prüfen

Prüfen Sie, ob ein Datum ein bestimmter Feiertag ist.

import { isSpecificHoliday } from 'feiertagejs';

const date = new Date('2026-10-03');
isSpecificHoliday(
  date, 
  'DEUTSCHEEINHEIT',
  'ALL'
);
// => true

Sonntag oder Feiertag?

Praktisch für Geschäftslogik: Prüfen Sie beides auf einmal.

import { isSunOrHoliday } from 'feiertagejs';

const today = new Date();

if (isSunOrHoliday(today, 'NW')) {
  console.log('Geschlossen!');
}

API Referenz

Die wichtigsten Funktionen im Überblick:

Funktion	Beschreibung	Rückgabe
`isHoliday(date, region)`	Prüft ob ein Datum ein Feiertag ist	`boolean`
`getHolidays(year, region)`	Gibt alle Feiertage eines Jahres zurück	`Holiday[]`
`getHolidayByDate(date, region)`	Gibt den Feiertag für ein Datum zurück	`Holiday \| undefined`
`isSpecificHoliday(date, name, region)`	Prüft ob ein Datum ein bestimmter Feiertag ist	`boolean`
`isSunOrHoliday(date, region)`	Prüft ob ein Datum Sonntag oder Feiertag ist	`boolean`
`addTranslation(isoCode, translation)`	Fügt eine neue Übersetzung hinzu	`void`

Unterstützte Bundesländer

Feiertage.js unterstützt alle deutschen Bundesländer:

BW

Baden-Württemberg

BY

Bayern

BE

Berlin

BB

Brandenburg

HB

Bremen

HH

Hamburg

HE

Hessen

MV

Mecklenburg-Vorpommern

NI

Niedersachsen

NW

Nordrhein-Westfalen

RP

Rheinland-Pfalz

SL

Saarland

SN

Sachsen

ST

Sachsen-Anhalt

SH

Schleswig-Holstein

TH

Thüringen

Spezielle Regionen

BUND

Bundesweite Feiertage (in allen Bundesländern gültig)

ALL

Alle Feiertage (mind. in einem Bundesland gültig)

AUGSBURG

Stadt Augsburg (inkl. Friedensfest)

Unterstützte Feiertage

Neujahrstag

Heilige Drei Könige

Karfreitag

Ostersonntag

Ostermontag

Tag der Arbeit

Christi Himmelfahrt

Pfingstsonntag

Pfingstmontag

Fronleichnam

Mariä Himmelfahrt

Tag der Deutschen Einheit

Reformationstag

Allerheiligen

Buß- und Bettag

Erster Weihnachtsfeiertag

Zweiter Weihnachtsfeiertag

Weltkindertag

Weltfrauentag

Augsburger Friedensfest

Über das Projekt

Feiertage.js wurde von Simon Fakir entwickelt und wird von der Open-Source-Community gepflegt. Das Modul wird aktiv weiterentwickelt und ist produktionsreif.

10.000+ monatliche Downloads

npm Downloads

70+ GitHub Stars

Open Source

Aktuelle Version: 1.5.x

Stable Release

Jetzt loslegen

Feiertage.js ist kostenlos und Open Source. Probieren Sie es aus!

Sie möchten Feiertage.js in einem geschäftskritischen System einsetzen oder brauchen Hilfe bei der Integration? Melden Sie sich gerne bei uns – wir unterstützen Sie beim Architektur-Design, bei Integrationen und beim zuverlässigen Betrieb.

npm install feiertagejs

Zum GitHub Repository Business Support & Integration anfragen

Zurück zur Startseite