Lorixen.
DE

Schaltjahr und Monatsende: Datumsfehler in Web-Apps

Kurz gesagt: Der 29. Februar und das Monatsende sind die Stellen, an denen Datumsberechnungen in Web-Apps am häufigsten schiefgehen. Ein Abo, das am 31. Januar beginnt, verlängert sich plötzlich auf den 2. oder 3. März. Ein Jahrespass, der am 29. Februar gekauft wurde, hat im Folgejahr kein gültiges Enddatum. Eine Erinnerung „jeden 30. des Monats“ fällt im Februar aus. Die Ursache ist fast immer dieselbe: Es wird mit Tagen gerechnet, ohne festzulegen, was passieren soll, wenn ein Tag im Zielmonat nicht existiert. Wer diese Regel einmal bewusst festlegt und testet, erspart sich Rückfragen, Gutschriften und falsche Rechnungen.

Wo die Fehler auftreten

Datumsfehler bleiben oft monatelang unbemerkt, weil sie nur an wenigen Tagen im Jahr auftreten. Typische Stellen (Beispiele zur Veranschaulichung):

  • Monatsabos und Lieferintervalle: Eine Kaffeerösterei in Bern verschickt Abo-Pakete „monatlich ab Bestelldatum“. Wer am 31. bestellt, rutscht in kurzen Monaten in den nächsten Monat.
  • Laufzeiten von Mitgliedschaften: Ein Fitnessstudio in Basel verkauft Jahresabos. Ein am 29. Februar gestartetes Abo braucht ein Enddatum, das es im nächsten Jahr gibt.
  • Wiederkehrende Termine: Eine Hausverwaltung erinnert Mieterinnen und Mieter monatlich an einen Ablesetermin am 30. Im Februar gibt es diesen Tag nicht.
  • Fristen in Tagen oder Monaten: „Zahlbar innert 30 Tagen“ ist eindeutig, „innert eines Monats“ nicht.
  • Auswertungen: Ein Bericht „Umsatz pro Monat“ vergleicht 28 mit 31 Tagen, ohne darauf hinzuweisen.

Warum JavaScript-Daten überlaufen

Das klassische JavaScript-Datum rechnet ungültige Tage einfach weiter. MDN erklärt das bei der Methode setMonth() an einem Beispiel: Ist das aktuelle Datum der 31. Januar 2016 und setzt man den Monat auf Februar, ergibt sich der 2. März 2016, weil der Februar 2016 nur 29 Tage hatte. Der Überschuss wird also in den Folgemonat übertragen.

MDN weist ausserdem darauf hin, dass setMonth() in lokaler Zeit arbeitet. Wird dabei eine Umstellung zwischen Sommer- und Winterzeit überschritten, kann die tatsächlich vergangene Zeit von der erwarteten abweichen.

Viele andere Programmiersprachen und Bibliotheken verhalten sich anders: Manche begrenzen auf den letzten Tag des Monats, andere werfen einen Fehler. Wenn Ihr System aus mehreren Teilen besteht, etwa einer Web-App in JavaScript und einem Server in einer anderen Sprache, kann dieselbe Rechnung an zwei Stellen zwei Ergebnisse liefern.

Die neue Datums-API macht die Regel sichtbar

Die neuere Temporal-API in JavaScript zwingt dazu, die Frage ausdrücklich zu beantworten. Laut MDN kennt die Methode add() bei Temporal.PlainDate eine Option overflow mit zwei Werten:

  • constrain (Voreinstellung): Der Tag wird auf den gültigen Bereich begrenzt. Aus dem 31. Januar plus ein Monat wird der letzte Februartag.
  • reject: Liegt der Tag ausserhalb des gültigen Bereichs, wird ein Fehler ausgelöst.

Ob Sie Temporal schon einsetzen können, hängt von den Browsern und Laufzeitumgebungen ab, die Sie unterstützen. Prüfen Sie die Kompatibilitätsangaben bei MDN. Unabhängig davon ist das Modell hilfreich: Es gibt keine richtige Antwort, nur eine bewusst gewählte.

Die Geschäftsregel zuerst festlegen

Bevor Sie Code ändern, klären Sie mit den Verantwortlichen im Betrieb, was in jedem Fall gelten soll. Schreiben Sie die Regeln in einfachen Sätzen auf:

  1. Monatsintervalle: „Fällt der Termin auf einen Tag, den es im Zielmonat nicht gibt, gilt der letzte Tag dieses Monats.“
  2. Ursprungstag merken: „Ein Abo vom 31. Januar wird am 28. oder 29. Februar und danach wieder am 31. März verlängert, nicht am 28. März.“ Dafür muss der ursprüngliche Tag gespeichert werden, nicht nur das letzte berechnete Datum.
  3. Jahreslaufzeiten: „Eine am 29. Februar begonnene Jahreslaufzeit endet am 28. Februar des Folgejahres“ oder „am 1. März“. Beides ist vertretbar, entscheidend ist, dass es festgelegt und kommuniziert ist.
  4. Fristen: Wo möglich in Tagen statt Monaten rechnen, weil Tage eindeutig sind.

Die zweite Regel ist besonders wichtig. Viele Systeme berechnen jeden Termin aus dem vorherigen. Dann wandert ein Abo vom 31. im Laufe des Jahres auf den 28. und bleibt dort, obwohl die Kundin den 31. gewählt hat.

Speichern als reines Datum

Für Laufzeiten, Geburtstage und Fälligkeiten brauchen Sie meist nur ein Datum ohne Uhrzeit. Speichern Sie es auch so. Wird ein reines Datum als Zeitpunkt mit Uhrzeit und Zeitzone abgelegt, kann es bei einer Umrechnung auf den Vortag fallen. Gerade an Monatsgrenzen führt das zu doppelt falschen Ergebnissen.

Gezielt testen

Datumsfehler lassen sich gut mit festen Testfällen finden. Legen Sie eine kleine Liste an und prüfen Sie jede Berechnung damit:

    1. Januar plus 1 Monat, in einem Schaltjahr und in einem normalen Jahr,
    1. Februar plus 1 Jahr,
    1. eines Monats, wiederkehrend über zwölf Monate,
    1. Dezember plus 1 Tag und plus 1 Monat,
  • Termine kurz vor und nach der Zeitumstellung.

Lassen Sie diese Tests automatisch bei jeder Änderung laufen. Viele Testwerkzeuge erlauben es ausserdem, die aktuelle Systemzeit vorzutäuschen. So können Sie prüfen, was Ihre App am 29. Februar oder am Monatsletzten anzeigt, ohne bis dahin zu warten.

Kundinnen und Kunden informieren

Zeigen Sie das nächste Verlängerungs- oder Lieferdatum im Kundenkonto und in Bestätigungen konkret an, statt nur „monatlich“ zu schreiben. Wenn eine Regel greift, etwa die Verschiebung auf den Monatsletzten, hilft ein kurzer Hinweis in den häufigen Fragen. So entstehen keine Missverständnisse, wenn das Paket einmal am 28. statt am 31. kommt.

Bestehende Daten prüfen

Wenn Ihre App schon länger läuft, lohnt sich eine Abfrage über alle aktiven Abos und Termine: Wie viele haben ein Startdatum am 29., 30. oder 31.? Gibt es Einträge, deren Termin im Laufe der Zeit auf einen früheren Tag gewandert ist? Solche Fälle können Sie gezielt korrigieren, bevor sich jemand meldet.

Häufige Fragen

Wie oft treten diese Fehler auf?

Nur an wenigen Tagen im Jahr, deshalb bleiben sie lange unbemerkt. Betroffen sind aber jedes Mal alle Abos und Termine mit einem Starttag am Monatsende.

Was ist die richtige Regel für den 31.?

Es gibt keine allgemein richtige Regel. Üblich ist, auf den Monatsletzten zu begrenzen und den ursprünglichen Tag zu merken. Wichtig ist, dass die Regel festgelegt und überall gleich umgesetzt ist.

Reicht es, mit 30 Tagen statt einem Monat zu rechnen?

Für Fristen oft ja. Für Abos und Termine meist nicht, weil sich der Liefertag dann jeden Monat verschiebt.

Muss ich meine App auf Temporal umstellen?

Nicht zwingend. Wichtiger ist, die Regel festzulegen und mit Testfällen abzusichern. Temporal kann die Umsetzung vereinfachen, sofern Ihre Zielumgebungen es unterstützen.

Wenn Ihre Web-App Abos, Laufzeiten oder wiederkehrende Termine berechnet und Sie die Datumslogik absichern möchten, sprechen Sie mit uns: Datumslogik prüfen lassen.

Quellen

WhatsAppTermin buchen