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.