Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

ChronoUnit.DAYS.between — liczba dni między datami

ChronoUnit.DAYS.between(start, end) zwraca liczbę pełnych dni jako long. Dla LocalDate oblicza różnicę dat kalendarzowych; koniec przed początkiem daje wynik ujemny.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

long days = ChronoUnit.DAYS.between(startInclusive, endExclusive);

ChronoUnit.DAYS.between(start, end) zwraca long: liczbę pełnych dni między zgodnymi obiektami czasu. Początek jest włączony, a koniec wyłączony. Równoważny zapis to start.until(end, ChronoUnit.DAYS).

Dla LocalDate obliczana jest różnica dat kalendarzowych. Przykład obejmuje 29 lutego 2024: od 2024-02-28 do 2024-03-01 są 2 dni, nie 3. Odwrócenie tych argumentów daje -2, a identyczne daty dają 0.

Znaczenie pełnego dnia zależy od typu argumentów. DAYS jest jednostką daty; nie zakładaj, że dzień zawsze oznacza dokładnie 24 godziny, zwłaszcza przy zmianach czasu letniego. Argumenty muszą być niepuste, zgodne i obsługiwać tę jednostkę; brak obsługi powoduje UnsupportedTemporalTypeException. Obliczenie nie zmienia argumentów.

Przykłady

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate end = LocalDate.of(2024, 3, 1);

        System.out.println(ChronoUnit.DAYS.between(start, end));
        System.out.println(ChronoUnit.DAYS.between(end, start));
        System.out.println(ChronoUnit.DAYS.between(start, start));
    }
}

Wynik

2
-2
0

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła