WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

ChronoUnit.DAYS.between — Tage zwischen Datumsangaben

ChronoUnit.DAYS.between(start, end) gibt die Anzahl vollständiger Tage als long zurück. Bei LocalDate wird die Differenz der Kalenderdaten berechnet; liegt das Ende vor dem Anfang, ist das Ergebnis negativ.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

long days = ChronoUnit.DAYS.between(startInclusive, endExclusive);

ChronoUnit.DAYS.between(start, end) gibt einen long zurück: die Anzahl vollständiger Tage zwischen kompatiblen Zeitobjekten. Der Anfang ist eingeschlossen, das Ende ausgeschlossen. Eine gleichwertige Schreibweise ist start.until(end, ChronoUnit.DAYS).

Bei LocalDate wird die Differenz der Kalenderdaten berechnet. Das Beispiel umfasst den 29. Februar 2024: Vom 2024-02-28 bis zum 2024-03-01 sind es 2 Tage, nicht 3. Werden die Argumente vertauscht, ergibt sich -2; identische Daten ergeben 0.

Was ein vollständiger Tag bedeutet, hängt von den Argumenttypen ab. DAYS ist eine datumsbasierte Einheit; gehe nicht davon aus, dass ein Tag immer genau 24 Stunden bedeutet, insbesondere bei Zeitumstellungen. Die Argumente müssen ungleich null und kompatibel sein sowie die Einheit unterstützen; eine nicht unterstützte Einheit führt zu UnsupportedTemporalTypeException. Die Berechnung verändert die Argumente nicht.

Beispiele

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate end = LocalDate.of(2024, 3, 1);

        System.out.println(ChronoUnit.DAYS.between(start, end));
        System.out.println(ChronoUnit.DAYS.between(end, start));
        System.out.println(ChronoUnit.DAYS.between(start, start));
    }
}

Ergebnis

2
-2
0

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen