CKTIS / Java
Period — okres kalendarzowy między datami
java.time.Period opisuje okres w latach, miesiącach i dniach. Period.between oblicza taki okres między dwiema datami LocalDate, a nie czas trwania w sekundach.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
Period.between(LocalDate startDateInclusive, LocalDate endDateExclusive)java.time.Period to niemutowalna, bezpieczna wątkowo wartość opisująca lata, miesiące i dni w kalendarzu ISO. Służy do obliczeń kalendarzowych; Duration opisuje czas w sekundach i nanosekundach. Dzień kalendarzowy nie musi odpowiadać 24 godzinom przy zmianie czasu.
Period.between(start, end) przyjmuje dwie niepuste daty LocalDate: początek jest włączony, koniec wyłączony. Wyznacza pełne miesiące i pozostałe dni, następnie rozdziela miesiące na lata i miesiące. Wcześniejszy koniec daje okres ujemny.
getDays() zwraca tylko składową dni, nie łączną liczbę dni. W przykładzie P1Y2M3D oznacza rok, dwa miesiące i trzy dni. start.plus(period) tworzy nową datę; nie zmienia start.
Przykłady
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));
}
}Wynik
P1Y2M3D 3 2024-03-18
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.