Datumsdifferenz-Rechner

Ein Datumsdifferenz-Rechner misst den Abstand zwischen zwei Kalenderdaten und zeigt ihn als Tage, Wochen, ungefähre Monate, ungefähre Jahre sowie kleinere Einheiten wie Stunden oder Minuten an. Er ist hilfreich für Projektdauern, Urlaubszeiträume, Abrechnungsperioden, Jahrestage, Aufbewahrungsfristen und einfache historische Abstände. Das Ergebnis ist eine Datumsdifferenz und nicht automatisch eine inklusive Zählung beider Endpunkte: Vom 1. Januar bis zum 3. Januar beträgt der Abstand normalerweise zwei Tage, sofern keine Fachregel beide Tage mitzählt. Monate und Jahre sind häufig Näherungen, weil Monate unterschiedlich lang sind. Für Arbeitstage, Feiertage, Zeitzonen oder rechtliche Fristen sollten eigene Regeln verwendet werden.

Die exakte Tagesdifferenz wird als Math.floor((end.getTime() - start.getTime()) / 86_400_000) berechnet, wobei 86.400.000 die Anzahl der Millisekunden in einem nicht-Zeitzonenwechsel-behafteten 24-Stunden-Tag ist. Dies ergibt ein exklusives Intervall – vom 1. Januar bis zum 3. Januar sind es 2 Tage, nicht 3 – da die Subtraktion den Zeitraum zwischen zwei Zeitpunkten misst und nicht Kalenderfelder zählt. Für inklusives Zählen (beide Endpunkte mitzählen) addiert man 1 zum Ergebnis; viele arbeitsrechtliche, urlaubs- und abrechnungsbezogene Regeln erfordern dies, und der Off-by-one-Fehler ist die häufigste Ursache für Abweichungen zwischen HR- und Finanzberichten. Wochen sind einfach Tage / 7; die Seite zeigt außerdem Stunden = Tage * 24, Minuten = Tage * 1440 und Sekunden = Tage * 86.400 als abgeleitete Gesamtwerte an. Monats- und Jahresdifferenzen sind bewusst als „ungefähr” gekennzeichnet, da Kalendermonate und -jahre unterschiedlich lang sind. Der einfache Ansatz ist Tage / 30,436875 (durchschnittlicher Gregorianischer Monat) und Tage / 365,2425 (durchschnittliches Gregorianisches Jahr über einen 400-Jahres-Zyklus), was für Statusberichte und Dashboards ausreicht, aber für Verträge ungenau ist. Für eine kalendergenaue Berechnung „X volle Monate zwischen” subtrahiert der Algorithmus die Komponenten Jahr × 12 + Monat und dekrementiert um 1, wenn der Endtag früher als der Starttag liegt – so berechnen es die meisten Datumsbibliotheken (date-fns differenceInMonths, dayjs $.diff('month'), Temporal Duration.from). Die Jahresberechnung hat dieselbe Eigenheit: 2024-02-29 bis 2025-02-28 wird je nach Konvention manchmal als 1 Jahr (Begrenzung auf das Monatsende) und manchmal als 0 Jahre 11 Monate 30 Tage gezählt. Schaltjahre folgen der Gregorianischen Regel (durch 4 teilbar, außer Jahrhundertjahre, die nicht durch 400 teilbar sind, also 1900 = Gemeinjahr, 2000 = Schaltjahr, 2024 = Schaltjahr). Ein Zeitraum, der den 29. Februar einschließt, erhält automatisch einen zusätzlichen Tag, da die Tageszählung auf Millisekunden seit Epoche verankert ist und nicht auf Kalenderfeldern. Die Zeitzonenbehandlung ist kritisch, wenn beide Endpunkte unter Tagesauflösung liegen: Die Subtraktion zweier Date-Werte aus lokalen Zeitstrings kann um den lokalen UTC-Offset abweichen, und ein Zeitraum, der einen Zeitzonenwechsel kreuzt, kann 23 oder 25 Stunden statt der nominellen 24 betragen. Das Y2038-Problem (signed 32-Bit-Überlauf von Unix time_t am 2038-01-19T03:14:07Z) betrifft diese Seite nicht, da JavaScript Date eine 64-Bit-Float verwendet, die Daten bis etwa 100 Millionen Tage beiderseits der Epoche darstellen kann, aber nachgelagerte Systeme in 32-Bit-C benötigen weiterhin Aufmerksamkeit.

• Exakte Tage = Math.floor((end - start) / 86_400_000); 86,4 Mio. ms pro nicht-Zeitzonenwechsel-Tag.
• Ergebnis ist standardmäßig exklusiv: 1. Jan. bis 3. Jan. = 2 Tage; +1 für inklusives Zählen (beide Endpunkte).
• Ungefährer Monat verwendet durchschnittlich 30,436875 Tage; Jahr verwendet 365,2425 Tage über den 400-jährigen Gregorianischen Zyklus.
• Kalendergenaue Monatsdifferenz: (J2-J1)*12 + (M2-M1), dann -1, wenn Endtag < Starttag – entspricht date-fns differenceInMonths.
• Schaltjahre: Durch 4 teilbar, außer Jahrhundertjahre müssen durch 400 teilbar sein (1900 nein, 2000 ja, 2024 ja).
• Zeitzonenwechsel erzeugen 23h- und 25h-Kalendertage; eine 24h-Subtraktion entspricht nicht immer einem Kalendertag.
• JavaScript Date ist eine 64-Bit-Float, immun gegen Unix Y2038 (32-Bit-time_t-Überlauf am 2038-01-19 03:14:07 UTC).