Jahrzehnte zwischen zwei Daten

Geben Sie ein Anfangs- und Enddatum im Format YYYY-MM-DD ein. Das Ergebnis ist positiv, wenn das Enddatum später liegt, negativ, wenn es früher liegt, und null, solange keine vollen zehn Jahre vergangen sind. Die Berechnung folgt festen gregorianischen Kalenderregeln in UTC; aktuelle Uhrzeit, Browser-Zeitzone und externe Dienste können das Ergebnis nicht verändern.

Was ein volles Jahrzehnt bei dieser Berechnung bedeutet

Ein volles Jahrzehnt ist ein abgeschlossener Kalenderzeitraum von zehn Jahren ab dem ersten Datum und nicht nur ein Vergleich der üblichen Jahrzehntbezeichnungen. Vom 15. Juni 2000 bis zum 14. Juni 2020 ist lediglich ein Jahrzehnt vollständig vergangen, weil bis zum zweiten Zehnjahrestag noch ein Tag fehlt. Am 15. Juni 2020 wird das Ergebnis zwei. Diese Unterscheidung verhindert, dass Datumswerte kurz vor einem Jahrestag nur aufgrund einer Differenz von zwanzig Jahreszahlen aufgerundet werden. Daher können zwei Daten in unterschiedlich bezeichneten Jahrzehnten liegen und dennoch null ergeben. Die Ausgabe ist bewusst ganzzahlig und verwirft den unvollständigen Rest nach dem letzten erreichten Zehnjahrestag. Das eignet sich für Richtlinien, Archive, Verträge oder Berichtsregeln, die abgeschlossene Jahrzehnte statt einer ungefähren Zeitspanne verlangen. Beide Eingaben müssen explizite ISO-Kalenderdaten im Format YYYY-MM-DD sein. Dadurch bleibt die Auslegung sichtbar, eindeutig und bei jeder Berechnung reproduzierbar.

Vorzeichen, UTC-Regeln und Schalttage

Das Vorzeichen richtet sich nach der Reihenfolge Ihrer Angaben. Liegt das zweite Datum nach dem ersten, ist die Zahl positiv. Liegt es davor, wird dieselbe Anzahl voller Jahrzehnte als negative ganze Zahl ausgegeben. Gleiche Daten ergeben null. Beim Vertauschen der beiden Daten ändert sich somit das Vorzeichen, nicht aber der Betrag; das ist für Sortierungen, Vergleiche und gerichtete Berechnungen hilfreich. Prüfung und Kalenderarithmetik verwenden den proleptischen gregorianischen Kalender und nicht das JavaScript-Date-Objekt. Weder lokale Zeitzonenumrechnung noch Sommerzeitwechsel, aktuelle Uhr, Netzabfrage oder sprachabhängiger Parser wirken mit. Beginnt der Zeitraum am 29. Februar, gilt in einem nicht als Schaltjahr ausgeführten Zieljahr der 28. Februar als Jahrestag. Diese eindeutige Begrenzung liefert an Schaltjahrgrenzen stabile Werte und entspricht der üblichen Kalenderdauer-Arithmetik. Zulässig sind Jahre von 0001 bis 9999.

So verwenden Sie das Ergebnis zuverlässig

Senden Sie das anfängliche ISO-Datum im Feld from und das abschließende ISO-Datum im Feld to. Die Antwort wiederholt beide geprüften Eingaben, enthält die vorzeichenbehaftete Jahrzehntezahl und kennzeichnet die Richtung als vorwärts, rückwärts oder null. Verwenden Sie die Ganzzahl direkt, wenn abgeschlossene Zehnjahreszeiträume benötigt werden, etwa um lang laufende Programme nach Laufzeit zu gruppieren, das Erreichen eines Jubiläums zu prüfen oder den Abstand historischer Unterlagen zu beschreiben. Behandeln Sie sie nicht als Dezimalschätzung von Jahren: Ein Ergebnis von drei besagt, dass drei volle Kalenderjahrzehnte verstrichen sind, nicht dass zwischen den Daten exakt dreißig Jahre ohne verbleibende Monate oder Tage liegen. Die Funktion leitet außerdem keine Daten aus natürlicher Sprache, regionalen Formaten, Zeitstempeln oder der Gegenwart ab. Diese Einschränkungen sorgen dafür, dass wiederholte API-Aufrufe deterministisch bleiben. Eine API-Anfrage kostet $0.002; die Browser-Version führt dieselbe reine Berechnung aus und liefert dasselbe Ergebnis.