Ein leichtgewichtiges TypeScript npm Modul zur Berechnung deutscher Feiertage für jedes Bundesland – ohne Abhängigkeiten.
npm install feiertagejsInstallieren Sie Feiertage.js mit Ihrem bevorzugten Package Manager:
npm install feiertagejsyarn add feiertagejspnpm add feiertagejsSo 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'
);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.
pnpm add dayjs-feiertage dayjsnpm install dayjs-feiertage dayjsyarn add dayjs-feiertage dayjsimport 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[]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');
// => trueErhalten 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'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'
);
// => truePraktisch 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!');
}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 |
Feiertage.js unterstützt alle deutschen Bundesländer:
BWBaden-Württemberg
BYBayern
BEBerlin
BBBrandenburg
HBBremen
HHHamburg
HEHessen
MVMecklenburg-Vorpommern
NINiedersachsen
NWNordrhein-Westfalen
RPRheinland-Pfalz
SLSaarland
SNSachsen
STSachsen-Anhalt
SHSchleswig-Holstein
THThüringen
BUNDBundesweite Feiertage (in allen Bundesländern gültig)
ALLAlle Feiertage (mind. in einem Bundesland gültig)
AUGSBURGStadt Augsburg (inkl. Friedensfest)
Feiertage.js wurde von Simon Fakir entwickelt und wird von der Open-Source-Community gepflegt. Das Modul wird aktiv weiterentwickelt und ist produktionsreif.
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.