German public holidays for all 16 states. Movable holidays, bridge days, isFeiertag — TypeScript-first, zero dependencies, CLI included.

→ Live Demo

• All 16 federal states — correct holiday rules per Bundesland
• Movable holidays — Easter, Pentecost, Corpus Christi, etc. calculated automatically
• Brückentage — find bridge day opportunities to maximize your time off
• CLI included — npx german-holidays 2026 BY
• TypeScript-first — full type safety, no @types needed
• Zero dependencies — pure date arithmetic, no date library
• Tiny — <2KB gzipped (library), tree-shakeable
• Dual format — ESM + CJS

npm install german-holidays

import { getFeiertage, isFeiertag, getBrueckentage } from 'german-holidays';

// Get all holidays for Bayern 2026
const holidays = getFeiertage(2026, 'BY');

// Check if a date is a holiday
const result = isFeiertag('2026-12-25', 'BY');
// → { date: '2026-12-25', name: '1. Weihnachtstag', ... }

// Find bridge day opportunities
const brueckentage = getBrueckentage(2026, 'BY');
// → [{ date: '2026-05-15', feiertag: 'Christi Himmelfahrt', urlaubstage: 1, freieTage: 4, ... }]

# All nationwide holidays
npx german-holidays 2026

# Holidays for a specific state
npx german-holidays 2026 BY

# Bridge day opportunities
npx german-holidays --brueckentage 2026 NW

# English names
npx german-holidays 2026 BY --en

Returns all public holidays for a given year and state.

const holidays = getFeiertage(2026, 'BY');
// → Feiertag[]

Check if a date is a public holiday. Returns the holiday or undefined.

isFeiertag('2026-12-25', 'BY');  // → Feiertag
isFeiertag('2026-03-15', 'BY');  // → undefined
isFeiertag(new Date(), 'BY');    // Date objects work too

Calculate bridge day opportunities — workdays between holidays and weekends.

const bridges = getBrueckentage(2026, 'BY');
// → Brueckentag[]

Each Brueckentag contains:

Returns only nationwide holidays (9 per year).

Returns [month, day] for Easter Sunday. Useful for custom calculations.

easterSunday(2026); // → [4, 5] (April 5)

import type { Bundesland, Feiertag, Brueckentag, DateString } from 'german-holidays';

MIT