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.