Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

LocalDate.of — tworzenie daty z roku, miesiąca i dnia

Utwórz datę ISO z trzech składników i sprawdź, jak oba przeciążenia walidują datę oraz dlaczego do porównania należy użyć `equals`, a nie `==`.

Wersja: Java SE 21

Składnia

public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)

LocalDate.of to statyczna metoda fabryczna klasy java.time.LocalDate. Przyjmuje rok, miesiąc i dzień miesiąca w tej kolejności. Zwraca niezmienną datę w kalendarzu ISO-8601, bez godziny i strefy czasowej. W przeciwieństwie do LocalDate.now() nie odczytuje zegara.

Drugim argumentem może być int od 1 (styczeń) do 12 (grudzień) albo stała typu wyliczeniowego java.time.Month, np. Month.JANUARY. Rok musi mieścić się w przedziale od -999999999 do 999999999 włącznie. Dzień musi należeć do zakresu 1–31 i istnieć w podanym miesiącu i roku. Wartość spoza zakresu lub nieistniejąca data, np. 29 lutego 2019 r., powoduje DateTimeException; metoda nie koryguje daty. Przekazanie null zamiast Month powoduje NullPointerException.

LocalDate to klasa oparta na wartości. Dwa wywołania dla 2020-01-01 dają daty równe według equals, ale nie ma gwarancji, że zwrócą odrębne obiekty. == porównuje referencje, nie daty. Nie używaj obiektów LocalDate do synchronizacji.

Przykłady

import java.time.DateTimeException;
import java.time.LocalDate;
import java.time.Month;

public class Main {
    public static void main(String[] args) {
        final int year = 2020;
        LocalDate january = LocalDate.of(year, 1, 1);
        LocalDate sameJanuary = LocalDate.of(year, Month.JANUARY, 1);
        LocalDate june = LocalDate.of(year, Month.JUNE, 1);
        LocalDate july = LocalDate.of(year, 7, 1);
        LocalDate previousDecember = LocalDate.of(year - 1, Month.DECEMBER, 31);

        System.out.println(january);
        System.out.println(june);
        System.out.println(july);
        System.out.println(previousDecember);
        System.out.println(january.equals(sameJanuary));

        try {
            LocalDate.of(year - 1, Month.FEBRUARY, 29);
        } catch (DateTimeException e) {
            System.out.println("DateTimeException");
        }
    }
}

Wynik

2020-01-01
2020-06-01
2020-07-01
2019-12-31
true
DateTimeException

Przykład wypisuje stałe daty ze stycznia, czerwca i lipca 2020 r. oraz datę z grudnia poprzedniego roku, obliczonego jako `year - 1`. Oba przeciążenia dają tę samą datę styczniową, więc `equals` zwraca `true`. Rok 2019 nie jest przestępny, dlatego blok `catch` wypisuje `DateTimeException`.

Powiązane lekcje

  • Java · Lekcja 4 · Zaawansowany · Wersja: 2
  • Java · Lekcja 11 · Zaawansowany · Wersja: 2

Źródła