Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

LocalDate.of — vytvoření data z roku, měsíce a dne

Vytvořte datum ISO ze tří složek, zvolte vhodnou přetíženou variantu a porovnávejte data podle hodnoty pomocí `equals`, ne podle referencí pomocí `==`.

Verze: Java SE 21

Syntaxe

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

LocalDate.of je statická tovární metoda třídy java.time.LocalDate. Přijímá rok, měsíc a den v měsíci v tomto pořadí. Vrací neměnné datum v kalendáři ISO-8601, bez denního času a časového pásma. Na rozdíl od LocalDate.now() nečte hodiny.

Druhý argument je buď int od 1 (leden) do 12 (prosinec), nebo konstanta výčtového typu java.time.Month, například Month.JANUARY. Rok musí být v rozsahu od -999999999 do 999999999 včetně. Den musí být od 1 do 31 a musí v daném měsíci a roce existovat. Hodnota mimo rozsah nebo neexistující datum, například 29. února 2019, vyvolá DateTimeException; metoda datum neupraví. Předání null místo Month vyvolá NullPointerException.

LocalDate je třída založená na hodnotě. Dvě volání pro 2020-01-01 vrátí data, která jsou podle equals shodná, ale nezaručují dva různé objekty. == porovnává reference, ne data. Instance LocalDate nepoužívejte k synchronizaci.

Příklady

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");
        }
    }
}

Výsledek

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

Program vypíše pevně zadaná data z ledna, června a července roku 2020 a datum z prosince předchozího roku, vypočteného jako `year - 1`. Obě přetížené varianty vrátí stejné lednové datum, takže `equals` vrátí `true`. Rok 2019 není přestupný, a proto blok `catch` vypíše `DateTimeException`.

Související lekce

  • Java · Lekce 4 · Pokročilá · Verze: 2
  • Java · Lekce 11 · Pokročilá · Verze: 2

Zdroje