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

CKTIS / Java

LocalDate: vytvoření, posun, porovnání a zobrazení dat

Vytvořte datum v kalendáři ISO, posuňte ho o kalendářní dny beze změny původní hodnoty, porovnejte ho s jiným datem a získejte jeho textový zápis.

Verze: Java SE 21

Syntaxe

import java.time.LocalDate;
import java.time.Month;
import java.time.chrono.ChronoLocalDate;

// Method signatures on LocalDate (Java SE 21)
public static LocalDate of(int year, int month, int dayOfMonth)
public static LocalDate of(int year, Month month, int dayOfMonth)
public LocalDate plusDays(long daysToAdd)
public boolean isAfter(ChronoLocalDate other)
public String toString()

java.time.LocalDate představuje datum v kalendáři ISO bez denní doby a časového pásma. Statická tovární metoda LocalDate.of přijímá v tomto pořadí rok, měsíc a den v měsíci. Měsíc zadejte jako int od 1 do 12 nebo jako hodnotu typu Month různou od null, například Month.FEBRUARY. Neplatné datum, například 29. únor v nepřestupném roce, se neopraví a metoda vyvolá DateTimeException.

date.plusDays(n) přijímá počet kalendářních dnů typu long a vrací výsledné datum, případně v jiném měsíci nebo roce. Záporná hodnota posouvá datum zpět, nula jeho hodnotu zachovává. LocalDate je neměnný: volání nezmění date, proto výsledek uložte nebo rovnou použijte. Pokud při výpočtu nedojde k přetečení, ale výsledné datum leží mimo podporovaný rozsah, metoda vyvolá DateTimeException, například při LocalDate.MAX.plusDays(1). Pokud v JDK 21 při mezivýpočtu přeteče součet počtu dnů od epochy a přičítaných dnů v typu long, metoda vyvolá ArithmeticException ještě před kontrolou rozsahu dat.

a.isAfter(b) vrací true, jen když je a pozdější než b. Je-li a dřívější nebo obě hodnoty označují stejný den, vrátí false. Parametr má typ ChronoLocalDate a b nesmí být null. Porovnává se poloha dat na místní časové ose bez ohledu na jejich kalendářní systémy.

date.toString() vrací String ve formátu ISO-8601 uuuu-MM-dd, například 2024-03-01. Metoda nic nevypisuje ani nepřizpůsobuje text místnímu nastavení. Pro formát určený čtenáři použijte format s vhodným DateTimeFormatter.

Příklady

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate start = LocalDate.of(2024, 2, 28);
        LocalDate later = start.plusDays(2);

        System.out.println(start.toString());
        System.out.println(later.toString());
        System.out.println(later.isAfter(start));
        System.out.println(later.isAfter(later));
    }
}

Výsledek

2024-02-28
2024-03-01
true
false

Rok 2024 je přestupný, takže dva dny po `2024-02-28` nastane `2024-03-01`. První řádek ukazuje, že původní datum se nezměnilo; poslední dva ukazují, že výsledek je pozdější než původní datum, ale není pozdější než on sám.

Související lekce

  • Java · Lekce 68 · Základní · Verze: 2

Zdroje