CKTIS / Java
LocalDate — dátum bez času a časového pásma
LocalDate predstavuje nemenný dátum kalendára ISO bez času a časového pásma. Umožňuje dátumy vytvárať, posúvať, porovnávať, parsovať a formátovať.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
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 ukladá dátum kalendára ISO bez času a časového pásma; samo osebe neurčuje okamih na časovej osi. Je nemenné a bezpečné pri použití vo viacerých vláknach. LocalDate.of(year, month, dayOfMonth) vytvorí dátum; mesiace sú číslované od 1 do 12. Neplatný dátum spôsobí DateTimeException.
LocalDate.plusDays vracia výsledok pripočítania dní a zohľadňuje hranice mesiacov aj priestupné roky; pôvodný objekt zostáva nezmenený. LocalDate.with(adjuster) použije pravidlo úpravy, zatiaľ čo LocalDate.with(field, newValue) nastaví pole. Riešenie neplatného dňa závisí od poľa: zmena mesiaca môže deň obmedziť na posledný deň mesiaca, neplatné DAY_OF_MONTH však spôsobí výnimku.
LocalDate.isAfter overuje, či je dátum neskorší. LocalDate.equals porovnáva hodnoty dátumov typu LocalDate, nie identitu objektov — nenahrádzajte ho operátorom ==. Pre dva objekty LocalDate vracia LocalDate.compareTo podľa poradia dátumov záporné číslo, nulu alebo kladné číslo; nepredpokladajte, že výsledok bude presne -1 alebo 1.
LocalDate.parse(text) načíta dátum ISO; preťaženie s formatterom podporuje iný formát. Chyba pri parsovaní spôsobí DateTimeParseException. LocalDate.toString vracia text ISO, zatiaľ čo LocalDate.format(formatter) použije zadaný formatter. Vo vzore dd/MM/uuuu znamená uuuu rok, nie rok éry (yyyy).
LocalDate.atTime(hour, minute) vytvorí LocalDateTime, stále bez časového pásma; preťaženie s OffsetTime vracia OffsetDateTime. Príklad používa pevné dátumy a ukazuje 29. február 2024. Rozsah dokumentácie: Java SE 21; produkčné prostredie nie je potvrdené.
Prí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ýsledok
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ýsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.