CKTIS / Java
Period — ein Kalenderzeitraum zwischen Datumsangaben
java.time.Period stellt einen Zeitraum in Jahren, Monaten und Tagen dar. Period.between berechnet diesen Zeitraum zwischen zwei LocalDate-Werten und nicht die verstrichene Zeit in Sekunden.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
Period.between(LocalDate startDateInclusive, LocalDate endDateExclusive)java.time.Period ist ein unveränderlicher, threadsicherer Wert, der Jahre, Monate und Tage im ISO-Kalender darstellt. Verwende ihn für Kalenderberechnungen; Duration beschreibt Zeit in Sekunden und Nanosekunden. Ein Kalendertag muss bei einer Zeitumstellung nicht 24 Stunden entsprechen.
Period.between(start, end) nimmt zwei nicht-null LocalDate-Werte entgegen: Der Anfang ist eingeschlossen, das Ende ausgeschlossen. Die Methode berechnet vollständige Monate und verbleibende Tage und teilt anschließend die Monate in Jahre und Monate auf. Ein früheres Ende ergibt einen negativen Zeitraum.
getDays() gibt nur die Tageskomponente zurück, nicht die Gesamtzahl der Tage. Im Beispiel bedeutet P1Y2M3D ein Jahr, zwei Monate und drei Tage. start.plus(period) erstellt ein neues Datum und ändert start nicht.
Beispiele
import java.time.LocalDate;
import java.time.Period;
public class Main {
public static void main(String[] args) {
LocalDate start = LocalDate.of(2023, 1, 15);
LocalDate end = LocalDate.of(2024, 3, 18);
Period period = Period.between(start, end);
System.out.println(period);
System.out.println(period.getDays());
System.out.println(start.plus(period));
}
}Ergebnis
P1Y2M3D 3 2024-03-18
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.