Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Period.between: lata, miesiące, dni i łączna liczba dni

Oblicz okres kalendarzowy między dwiema datami i odczytaj jego składowe. Jeśli potrzebujesz łącznej liczby dni, oblicz ją bezpośrednio z dat.

Wersja: Java SE 21

Składnia

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);

Statyczna metoda Period.between(start, end) z klasy java.time.Period przyjmuje dwie daty LocalDate, bez godziny i strefy czasowej. Data początkowa jest wliczana, a końcowa nie. Metoda wyznacza pełne miesiące i pozostałe dni, po czym dzieli pełne miesiące na lata po 12 miesięcy i resztę miesięcy.

Metody getYears(), getMonths() i getDays() zwracają jako int odpowiednio składową lat, miesięcy i dni. W wyniku between składowa miesięcy nie obejmuje miesięcy ujętych w latach, a składowa dni to tylko dni pozostałe po uwzględnieniu pełnych miesięcy. Dla identycznych dat wszystkie składowe wynoszą zero. Gdy data końcowa jest wcześniejsza od początkowej, każda niezerowa składowa jest ujemna.

Aby uzyskać łączną liczbę dni kalendarzowych, użyj ChronoUnit.DAYS.between(start, end) z pakietu java.time.temporal. Wynik to long; data końcowa nie jest wliczana, a wynik jest ujemny, gdy koniec poprzedza początek. Nie przeliczaj składowych Period przy założeniu stałej liczby dni w miesiącu lub roku: ich długość zależy od kalendarza.

Przykłady

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);
    }
}

Wynik

years=1
months=2
days=3
totalDays=428

Od `2023-01-15` do `2024-03-18` okres wynosi 1 rok, 2 miesiące i 3 dni. Dlatego `getDays()` zwraca `3`, a `ChronoUnit.DAYS.between(start, end)` zwraca `428`.

Powiązane lekcje

  • Java · Lekcja 68 · Podstawowy · Wersja: 2

Źródła