Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

LocalDate — data bez czasu i strefy

LocalDate reprezentuje niezmienną datę kalendarza ISO, bez godziny i strefy czasowej. Umożliwia tworzenie, przesuwanie, porównywanie oraz parsowanie i formatowanie dat.

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

Składnia

LocalDate.of(year, month, dayOfMonth)
date.plusDays(days)
date.isAfter(other)
date.toString()
date.equals(other)
date.compareTo(other)
date.with(adjuster)
date.with(field, newValue)
date.atTime(hour, minute)
LocalDate.parse(text)
LocalDate.parse(text, formatter)
date.format(formatter)

java.time.LocalDate przechowuje datę kalendarza ISO, bez czasu i strefy czasowej; sama nie określa chwili na osi czasu. Jest niezmienna i bezpieczna wątkowo. LocalDate.of(year, month, dayOfMonth) tworzy datę; miesiące mają numery 1–12. Nieprawidłowa data powoduje DateTimeException.

LocalDate.plusDays zwraca wynik dodania dni, uwzględniając granice miesięcy i lata przestępne; oryginał pozostaje bez zmian. LocalDate.with(adjuster) stosuje regułę korekty, a LocalDate.with(field, newValue) ustawia pole. Obsługa nieprawidłowego dnia zależy od pola: zmiana miesiąca może skrócić dzień do końca miesiąca, lecz nieprawidłowy DAY_OF_MONTH powoduje wyjątek.

LocalDate.isAfter sprawdza, czy data jest późniejsza. LocalDate.equals porównuje wartości dat typu LocalDate, nie tożsamość obiektów — nie zastępuj jej operatorem ==. Dla dwóch obiektów LocalDate metoda LocalDate.compareTo zwraca liczbę ujemną, zero lub dodatnią zgodnie z kolejnością dat; nie zakładaj wyniku dokładnie -1 lub 1.

LocalDate.parse(text) odczytuje datę ISO; przeciążenie z formatterem obsługuje inny format. Błąd parsowania powoduje DateTimeParseException. LocalDate.toString zwraca zapis ISO, a LocalDate.format(formatter) używa podanego formatera. We wzorcu dd/MM/uuuu symbol uuuu oznacza rok, nie rok ery (yyyy).

LocalDate.atTime(hour, minute) tworzy LocalDateTime, nadal bez strefy; przeciążenie z OffsetTime zwraca OffsetDateTime. Przykład używa stałych dat i pokazuje 29 lutego 2024. Zakres dokumentacji: Java SE 21; środowisko produkcyjne nie jest potwierdzone.

Przykłady

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.temporal.TemporalAdjusters;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate next = start.plusDays(1);
        LocalDate parsed = LocalDate.parse("2024-02-29");
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/uuuu");

        System.out.println(start.toString());
        System.out.println(next.toString());
        System.out.println(next.isAfter(start));
        System.out.println(next.equals(parsed));
        System.out.println(start.compareTo(next) < 0);
        System.out.println(start.with(TemporalAdjusters.lastDayOfMonth()));
        System.out.println(next.atTime(9, 30));
        System.out.println(next.format(formatter));
    }
}

Wynik

2024-02-28
2024-02-29
true
true
true
2024-02-29
2024-02-29T09:30
29/02/2024

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

Źródła