Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła