Quartale zu einem Datum addieren – mit Monatsendkorrektur

Jedes Quartal entspricht genau drei Kalendermonaten: Ein Quartal nach dem 30. November liegt im Februar des Folgejahres, vier Quartale ergeben ein Kalenderjahr. Fehlt der ursprüngliche Tag im Zielmonat, wird er auf dessen letzten gültigen Tag begrenzt. Die Berechnung nutzt deterministische gregorianische Ganzzahlarithmetik im UTC-Sinn, ohne JavaScript-Date, aktuelle Uhrzeit, Zeitzonenumrechnung, Netzwerk oder Zufall. Sie können sie im Browser kostenlos ausführen oder die API für $0.002 je erfolgreicher Anfrage nutzen, wenn ein reproduzierbares strukturiertes Ergebnis in einen automatisierten Ablauf gehört.

Was das Addieren von Kalenderquartalen bedeutet

Ein Kalenderquartal umfasst drei aufeinanderfolgende Monate und ist keine feste Dauer in Tagen, Stunden oder Sekunden. Ein Quartal verschiebt den Monat daher um drei und bewahrt den Tag, sofern er im Zielmonat vorkommt. Vier Quartale verschieben um zwölf Monate und führen gewöhnlich zum gleichen Monat und Tag des Folgejahres. Das Datum muss strikt als YYYY-MM-DD geschrieben sein und einen echten gregorianischen Tag bezeichnen; quarters muss ganzzahlig sein. Positive Werte gehen vorwärts, negative zurück, null lässt das Datum unverändert. So wird ein Quartal nicht fälschlich mit neunzig Tagen gleichgesetzt, denn reale Dreimonatszeiträume unterscheiden sich wegen Monatslängen und Schaltjahren. Die Antwort enthält Ausgangsdatum und Quartalszahl, das ISO-Ergebnis mit Jahr, Monat und Tag, die entsprechende Monatszahl, den Korrekturstatus und die Länge des Zielmonats. Eine Uhrzeit wird weder angenommen noch abgeleitet, weil eine zivilkalenderische und keine Laufzeitfrage beantwortet wird. Deshalb bleibt das Resultat unabhängig von Ausführungsort und lokaler Zeitzone stabil.

So funktionieren Prüfung und Monatsendkorrektur

Zunächst werden vier Jahres-, zwei Monats- und zwei Tagesziffern mit Bindestrichen verlangt. Danach wird der gregorianische Kalender geprüft: Monate reichen von 01 bis 12, der Tag muss tatsächlich existieren, und der 29. Februar gilt nur in durch vier teilbaren Jahren, ausgenommen nicht durch vierhundert teilbare Jahrhundertjahre. Der Algorithmus wandelt Jahr und Monat in einen ganzzahligen Monatsindex um, multipliziert die Quartalszahl mit drei, addiert den Versatz und gewinnt Zieljahr und -monat zurück. Anschließend wird der Ausgangstag mit der Länge des Zielmonats verglichen. Passt er, bleibt er erhalten; andernfalls wird der letzte Tag verwendet und clamped ist true. So ergibt der 30. November plus ein Quartal den 28. Februar eines normalen oder den 29. eines Schaltjahres. Ergebnisse außerhalb 0001 bis 9999 werden abgelehnt. Sämtliche Schritte verwenden endliche Ganzzahlen, kein Date, keine Uhr, keine lokalisierten Monatsnamen und keine laufzeitabhängigen Zeitzonenregeln.

Praktische Anwendungen und reproduzierbare Integration

Quartalsverschiebungen werden für Finanzberichte, Verlängerungen, Compliance-Prüfungen, Prognosen, Unterricht und Softwaretests benötigt. Finanzteams können den nächsten Prüftermin aus einem Quartalsabschluss ableiten, ohne ein Quartal stillschweigend durch neunzig Tage zu ersetzen. Produktteams prüfen, ob ein kurzer Zielmonat den Tag einer Verlängerung verändert. Analysten bilden Kohortengrenzen, Entwickler erzeugen in jeder Umgebung identische Testdaten. Negative Zahlen rekonstruieren Vergleichsdaten vor einem oder vier Quartalen. Da die Eingabe ein vollständiges Datum enthält und die Engine nie die aktuelle Zeit liest, liefert dieselbe Anfrage stets dieselbe Antwort. Das eignet sich für CI-Prüfungen, Caches, reproduzierbare Dokumentation und auditierte Abläufe. Die Browserausführung ist kostenlos; per API kostet jedes erfolgreiche Element $0.002, ungültige Eingaben werden abgewiesen. Für exakt verstrichene Tage oder Arbeitstage sind andere Werkzeuge vorgesehen. Diese Fähigkeit konzentriert sich bewusst auf ganze Dreimonatsquartale, bewahrt den Tag nach Möglichkeit und korrigiert ihn andernfalls vorhersehbar.