CKTIS / Java
Period.between: Jahre, Monate, Tage und Gesamttage
Ermittle den Kalenderzeitraum zwischen zwei Datumswerten und lies seine Bestandteile aus. Die Gesamtzahl der Tage berechnest du direkt aus den Datumswerten.
Version: Java SE 21
Syntax
import java.time.LocalDate;
import java.time.Period;
import java.time.temporal.ChronoUnit;
// start and end are LocalDate values.
Period period = Period.between(start, end);
int years = period.getYears();
int months = period.getMonths();
int days = period.getDays();
long totalDays = ChronoUnit.DAYS.between(start, end);Die statische Methode Period.between(start, end) der Klasse java.time.Period nimmt zwei LocalDate-Werte entgegen, also Datumswerte ohne Uhrzeit und Zeitzone. Das Startdatum zählt mit, das Enddatum nicht. Die Methode ermittelt die vollständigen Monate und die verbleibenden Tage. Danach zerlegt sie die vollständigen Monate in Jahre zu je 12 Monaten und übrige Monate.
Die Methoden getYears(), getMonths() und getDays() liefern den Jahres-, Monats- bzw. Tagesanteil jeweils als int. Im Ergebnis von between enthält der Monatsanteil keine Monate, die bereits als Jahre gezählt wurden, und der Tagesanteil enthält nur die Tage, die nach Abzug der vollständigen Monate übrig bleiben. Bei gleichen Datumswerten sind alle drei Anteile null. Liegt das Enddatum vor dem Startdatum, ist jeder von null verschiedene Anteil negativ.
Für die Gesamtzahl der Kalendertage verwendest du ChronoUnit.DAYS.between(start, end) aus java.time.temporal. Die Methode liefert einen long-Wert, zählt das Enddatum nicht mit und liefert ein negatives Ergebnis, wenn das Ende vor dem Start liegt. Rechne die Bestandteile von Period nicht mit einer festen Tageszahl pro Monat oder Jahr um: Ihre Länge hängt vom Kalender ab.
Beispiele
import java.time.LocalDate;
import java.time.Period;
import java.time.temporal.ChronoUnit;
public class PeriodExample {
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);
long totalDays = ChronoUnit.DAYS.between(start, end);
System.out.println("years=" + period.getYears());
System.out.println("months=" + period.getMonths());
System.out.println("days=" + period.getDays());
System.out.println("totalDays=" + totalDays);
}
}Ergebnis
years=1 months=2 days=3 totalDays=428
Von `2023-01-15` bis `2024-03-18` beträgt der Zeitraum 1 Jahr, 2 Monate und 3 Tage. Daher liefert `getDays()` den Wert `3`, während `ChronoUnit.DAYS.between(start, end)` den Wert `428` liefert.
Zugehörige Lektionen
- Java · Lektion 68 · Grundlagen · Version: 2