Open sandbox

How the Germany urlaubsanspruch calculator is verified

Inputs

InputFieldType
Leave year starts (YYYY-MM-DD)leaveYearStartstring
Leave year ends (YYYY-MM-DD)leaveYearEndstring
First day worked in it (YYYY-MM-DD)workStartstring
Last day worked in it (YYYY-MM-DD)workEndstring
Days you work per weekdaysPerWeeknumber
Days already takendaysTakennumber

The formula

Each derived value below is computed by the Valem engine from the expression shown, in this order. Nothing else runs — there is no hidden code path.

Derived valueFieldFormula (JSONata)
Weeks EntitlementweeksEntitlement$const.statutoryDays / $const.statutoryBasisDays
Full Year DaysfullYearDaysweeksEntitlement * daysPerWeek
Year Length DaysyearLengthDays$proRataDays(leaveYearStart, leaveYearEnd)
Present DayspresentDays$proRataDays(workStart, workEnd)
Accrual FractionaccrualFraction($f := presentDays / yearLengthDays; $f > 1 ? 1 : $f)
Days EntitleddaysEntitled$round(fullYearDays * accrualFraction, 1)
Days RemainingdaysRemaining($r := daysEntitled - $n(daysTaken); $r < 0 ? 0 : $round($r, 1))

Rates and thresholds

The expressions above read these as $const. They are the figures the annual refresh replaces, so they live as data rather than being written into the formulas — which is what makes a year-on-year change a one-line diff instead of an edit to arithmetic.

ConstantValue
statutoryDays24
statutoryBasisDays6

Test vectors (6)

Every case is executed against this model on each build, by the Java engine and independently by a JavaScript one. A mismatch of a single cent fails the build, so the page cannot ship advertising a figure the model no longer produces.

Case 1 — B1 a five-day week gets 20 days, NOT the statute’s 24

given leaveYearStart2026-01-01
given leaveYearEnd2026-12-31
given workStart2026-01-01
given workEnd2026-12-31
given daysPerWeek5
given daysTaken0
expect weeksEntitlement4
expect daysEntitled20

Case 2 — B2 a six-day week gets the statutory 24 exactly

given leaveYearStart2026-01-01
given leaveYearEnd2026-12-31
given workStart2026-01-01
given workEnd2026-12-31
given daysPerWeek6
given daysTaken0
expect daysEntitled24

Case 3 — B3 three days a week

given leaveYearStart2026-01-01
given leaveYearEnd2026-12-31
given workStart2026-01-01
given workEnd2026-12-31
given daysPerWeek3
given daysTaken0
expect daysEntitled12

Case 4 — B4 half a leave year on a five-day week

given leaveYearStart2026-01-01
given leaveYearEnd2026-12-31
given workStart2026-01-01
given workEnd2026-06-30
given daysPerWeek5
given daysTaken0
expect daysEntitled9.9

Case 5 — B5 no cap applies, unlike the UK

given leaveYearStart2026-01-01
given leaveYearEnd2026-12-31
given workStart2026-01-01
given workEnd2026-12-31
given daysPerWeek6
given daysTaken4
expect daysRemaining20

Case 6 — B6 joining partway through the leave year

given leaveYearStart2026-01-01
given leaveYearEnd2026-12-31
given workStart2026-10-01
given workEnd2026-12-31
given daysPerWeek5
given daysTaken0
expect presentDays92
expect daysEntitled5

Sources

Check it yourself — and reuse it

The whole model as JSON — inputs, outputs, formulas, vectors and sources in one re-runnable document.

This model is published under CC BY 4.0: use it, adapt it, build on it, with attribution. The licence covers the model — the expression of each rule and the arrangement of the catalog. The rates and thresholds are law, and nobody licenses those; the sources above are where they come from.

← Back to the Germany urlaubsanspruch calculator

Built with Valem — a live, verifiable calculator you can fork and embed.