Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje