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

CKTIS / Java

LocalDate — datum bez času a časového pásma

LocalDate představuje neměnné datum kalendáře ISO bez času a časového pásma. Umožňuje data vytvářet, posouvat, porovnávat, parsovat a formátovat.

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

Syntaxe

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 ukládá datum kalendáře ISO bez času a časového pásma; samo o sobě neurčuje okamžik na časové ose. Je neměnné a bezpečné pro použití ve více vláknech. LocalDate.of(year, month, dayOfMonth) vytvoří datum; měsíce jsou číslovány od 1 do 12. Neplatné datum způsobí DateTimeException.

LocalDate.plusDays vrací výsledek přičtení dnů a zohledňuje hranice měsíců i přestupné roky; původní objekt zůstane beze změny. LocalDate.with(adjuster) použije pravidlo úpravy, zatímco LocalDate.with(field, newValue) nastaví pole. Způsob řešení neplatného dne závisí na poli: změna měsíce může den omezit na poslední den měsíce, neplatné DAY_OF_MONTH však způsobí výjimku.

LocalDate.isAfter ověřuje, zda je datum pozdější. LocalDate.equals porovnává hodnoty dat typu LocalDate, nikoli identitu objektů — nenahrazujte ji operátorem ==. Pro dva objekty LocalDate vrací LocalDate.compareTo podle pořadí dat záporné číslo, nulu nebo kladné číslo; nepředpokládejte, že výsledek bude přesně -1 nebo 1.

LocalDate.parse(text) načte datum ISO; přetížení s formatterem podporuje jiný formát. Chyba při parsování způsobí DateTimeParseException. LocalDate.toString vrací text ISO, zatímco LocalDate.format(formatter) použije zadaný formatter. Ve vzoru dd/MM/uuuu znamená uuuu rok, nikoli rok éry (yyyy).

LocalDate.atTime(hour, minute) vytvoří LocalDateTime, stále bez časového pásma; přetížení s OffsetTime vrací OffsetDateTime. Příklad používá pevná data a ukazuje 29. února 2024. Rozsah dokumentace: Java SE 21; produkční prostředí není potvrzeno.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje