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.