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

CKTIS / Java

DateTimeFormatter — formátování a parsování dat

DateTimeFormatter převádí data a časy na text a text parsuje. Seznamte se se vzory, výslovným výběrem Locale, striktní validací a rozdíly mezi MM a mm i mezi uuuu a yyyy.

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

Syntaxe

DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm").withLocale(Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)

DateTimeFormatter je neměnný a bezpečný pro použití ve více vláknech. DateTimeFormatter.ofPattern vytvoří formátovač podle vzoru; lze jej opakovaně používat k formátování i parsování.

Rozdíl MM a mm: MM označuje měsíc se dvěma číslicemi, zatímco mm označuje minuty se dvěma číslicemi. Rozdíl uuuu a yyyy: uuuu označuje proleptický rok, zatímco yyyy označuje rok letopočtu. Pro striktní parsování dat ISO bez letopočtu použijte uuuu; samotné yyyy k určení data nestačí.

DateTimeFormatter.withLocale vrací formátovač se zvoleným Locale, který ovlivňuje například názvy měsíců. Ani DateTimeFormatter.withResolverStyle nemění původní objekt. Zvolte ResolverStyle.STRICT, chcete-li odmítat neplatná data. Výchozí režim ofPattern, SMART, může upravit den na konec měsíce, například 2023-02-29 na 2023-02-28.

Příklad přijme 2024-02-29 09:07, ale odmítne 2023-02-29 09:07. STRICT řídí rozlišení polí při parsování, nikoli formátování.

Příklady

import java.time.LocalDateTime;
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 formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd HH:mm")
                .withLocale(Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);

        LocalDateTime value = LocalDateTime.parse("2024-02-29 09:07", formatter);
        System.out.println(value.format(formatter));

        try {
            LocalDateTime.parse("2023-02-29 09:07", formatter);
            throw new AssertionError("Expected rejection");
        } catch (DateTimeParseException ex) {
            System.out.println("Invalid date rejected");
        }
    }
}

Výsledek

2024-02-29 09:07
Invalid date rejected

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