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

CKTIS / Java

Načítání, vytváření a formátování data a data s časem v Javě

Vytvářejte data z jednotlivých polí, načítejte text v ISO nebo vlastním formátu a formátujte data s časem i bez něj, aniž byste přiřazovali časové pásmo.

Verze: Java SE 21

Syntaxe

Java SE 21 — java.time.LocalDate and java.time.LocalDateTime; formatter type: java.time.format.DateTimeFormatter

Static factory and parsing methods:
LocalDate LocalDate.of(int year, int month, int dayOfMonth)
LocalDate LocalDate.of(int year, Month month, int dayOfMonth)
LocalDate LocalDate.parse(CharSequence text)
LocalDate LocalDate.parse(CharSequence text, DateTimeFormatter formatter)
LocalDateTime LocalDateTime.of(LocalDate date, LocalTime time)
LocalDateTime LocalDateTime.of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime.of also accepts java.time.Month instead of an int month. Both component-based forms have overloads with a trailing int second or with trailing int second, int nanoOfSecond.

Instance methods:
String date.format(DateTimeFormatter formatter) // date: LocalDate
String date.toString() // date: LocalDate
String dateTime.format(DateTimeFormatter formatter) // dateTime: LocalDateTime

V balíčku java.time představuje LocalDate samotné datum ISO, zatímco LocalDateTime spojuje datum ISO s místním časem. Ani jeden typ neukládá časové pásmo nebo posun vůči UTC a sám o sobě neurčuje jednoznačný okamžik. Oba typy jsou neměnné.

LocalDate.of(year, month, dayOfMonth) je statická tovární metoda, která přijímá číslo měsíce od 1 do 12 nebo konstantu Month. Statická tovární metoda LocalDateTime.of(date, time) spojuje LocalDate a LocalTime. Přetížené varianty s jednotlivými poli přijímají číslo měsíce nebo Month, vyžadují hodinu a minutu a umožňují přidat sekundu a poté nanosekundu. Vynechaná sekunda nebo nanosekunda má hodnotu nula. Neplatné hodnoty polí, například 29. únor v nepřestupném roce, vyvolají DateTimeException.

Statická metoda LocalDate.parse(text) používá DateTimeFormatter.ISO_LOCAL_DATE, například pro 2024-02-29. Přetížená varianta LocalDate.parse(text, formatter) používá předaný formátovač, například se vzorem dd/MM/uuuu. Pokud text nelze převést na datum, vyvolá se DateTimeParseException. DateTimeFormatter.ofPattern ve výchozím nastavení používá SMART, který může upravit 29/02/2023 na 28. února. Chcete-li taková data odmítat, nastavte ResolverStyle.STRICT a použijte uuuu (rok), nikoli yyyy (rok éry).

Instanční metody LocalDate.format(formatter) a LocalDateTime.format(formatter) vracejí pomocí předaného formátovače String, aniž by změnily hodnotu. Pokud požadované pole chybí, například hodina pro HH:mm u LocalDate, formátování vyvolá DateTimeException. LocalDate.toString() nepřijímá formátovač a vrací text ISO-8601, například 2024-02-29. Ve vzorech záleží na velikosti písmen: MM znamená měsíc, mm minutu a HH hodinu ve 24hodinovém formátu.

Příklady

import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;
import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        DateTimeFormatter dateFormat = DateTimeFormatter
                .ofPattern("dd/MM/uuuu", Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);
        DateTimeFormatter dateTimeFormat = DateTimeFormatter
                .ofPattern("dd/MM/uuuu HH:mm", Locale.ROOT);

        LocalDate date = LocalDate.of(2024, 2, 29);
        LocalDate fromIso = LocalDate.parse("2024-02-29");
        LocalDate fromCustom = LocalDate.parse("29/02/2024", dateFormat);

        System.out.println(date.equals(fromIso) && date.equals(fromCustom));
        System.out.println(date.toString());
        System.out.println(date.format(dateFormat));

        LocalDateTime dateTime = LocalDateTime.of(date, LocalTime.of(9, 5));
        System.out.println(dateTime.format(dateTimeFormat));

        try {
            LocalDate.parse("29/02/2023", dateFormat);
            System.out.println("Unexpected success");
        } catch (DateTimeParseException e) {
            System.out.println("Invalid date rejected");
        }
    }
}

Výsledek

true
2024-02-29
29/02/2024
29/02/2024 09:05
Invalid date rejected

První řádek potvrzuje, že obě načtené hodnoty odpovídají datu z tovární metody. Další tři řádky ukazují datum ISO, datum ve vlastním formátu a datum s časem. Poslední řádek ukazuje, že striktní načítání odmítne 29. únor 2023.

Související lekce

  • Java · Lekce 61 · Pokročilá · Verze: 2

Zdroje