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

CKTIS / Java

DateTimeFormatter: vzory, místní nastavení a striktní parsování

Vzorem a místním nastavením urči podobu textu a režimem vyhodnocení pravidla kontroly data. Rozlišuj `MM` a `mm` i `uuuu` a `yyyy`.

Verze: Java SE 21

Syntaxe

java.time.format.DateTimeFormatter (Java SE 21)
static DateTimeFormatter ofPattern(String pattern)
static DateTimeFormatter ofPattern(String pattern, Locale locale)
DateTimeFormatter withLocale(Locale locale)
DateTimeFormatter withResolverStyle(ResolverStyle resolverStyle)

Locale: java.util.Locale
ResolverStyle: java.time.format.ResolverStyle

Statická metoda DateTimeFormatter.ofPattern vytváří formátovač podle vzoru. Přetížení ofPattern(String) používá výchozí místní nastavení kategorie FORMAT, zatímco ofPattern(String, Locale) používá zadané nastavení. Obě začínají v režimu SMART. Neplatný vzor vyvolá IllegalArgumentException už při vytváření formátovače.

Ve vzoru záleží na velikosti písmen: dd je den v měsíci, MM je číslo měsíce a mm jsou minuty. dd-MM-uuuu, dd/MM/uuuu a uuuu-MM-dd určují pořadí polí a oddělovače. uuuu je proleptický rok (zahrnuje rok nula), zatímco yyyy je rok v éře. Při striktním parsování ISO nestačí yyyy spolu s měsícem a dnem k vytvoření LocalDate, protože se žádná éra nepředpokládá. Pro data bez éry používej uuuu.

DateTimeFormatter.withLocale nastaví Locale vráceného formátovače. Ovlivňuje text, například úplné názvy měsíců (MMMM), při formátování i parsování. Nemění však pořadí polí ani oddělovače v explicitním vzoru. Formátovače jsou neměnné a bezpečné pro sdílení mezi vlákny: uchovej výsledek withLocale nebo withResolverStyle, protože původní objekt se nemění.

DateTimeFormatter.withResolverStyle řídí druhou fázi parsování: po načtení polí podle vzoru z nich formátovač sestaví datum. Na formátování nemá vliv. U dat ISO režim STRICT odmítá neexistující data, SMART může posunout den v rozmezí 1–31 na poslední den měsíce a LENIENT může přenést přebytečné dny do dalšího měsíce. LocalDate.parse(text, formatter) vyvolá DateTimeParseException, pokud text neodpovídá vzoru nebo z něj nelze sestavit datum.

Příklady

import java.time.LocalDate;
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) {
        LocalDate date = LocalDate.of(2024, 1, 5);
        DateTimeFormatter english = DateTimeFormatter.ofPattern("dd MMMM uuuu", Locale.US);
        DateTimeFormatter french = english.withLocale(Locale.FRANCE);
        System.out.println(date.format(english));
        System.out.println(date.format(french));

        DateTimeFormatter smart = DateTimeFormatter.ofPattern("dd-MM-uuuu", Locale.ROOT);
        DateTimeFormatter strict = smart.withResolverStyle(ResolverStyle.STRICT);
        String invalid = "31-02-2024";
        System.out.println("SMART: " + LocalDate.parse(invalid, smart));
        try {
            System.out.println("STRICT: " + LocalDate.parse(invalid, strict));
        } catch (DateTimeParseException e) {
            System.out.println("STRICT: rejected");
        }
    }
}

Výsledek

05 January 2024
05 janvier 2024
SMART: 2024-02-29
STRICT: rejected

Místní nastavení mění název měsíce, nikoli strukturu data. Názvy závisí na lokalizačních datech běhového prostředí. Pro `31-02-2024` vrátí `SMART` hodnotu `2024-02-29`, zatímco `STRICT` vstup odmítne.

Související lekce

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

Zdroje