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

CKTIS / Java

ResolverStyle — striktní sestavování data z polí

ResolverStyle určuje, jak se z načtených polí sestaví datum nebo čas. Chování ResolverStyle.STRICT závisí na polích: při sestavování kalendářního data ISO z roku, měsíce a dne tento styl odmítne 29. únor v nepřestupném roce.

Verze: Java SE 21 (documentation scope); repository and production runtimes not attested

Syntaxe

DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)

ResolverStyle je výčtový typ v java.time.format. Při parsování se nejprve načtou hodnoty polí z textu. Ve druhé fázi se z těchto hodnot sestaví datum nebo čas. Styl řídí tuto druhou fázi, nikoli počáteční porovnání textu se vzorem ani formátování výstupu.

Při sestavování kalendářního data ISO z roku, měsíce a dne vyžaduje ResolverStyle.STRICT, aby den existoval v daném měsíci a roce. U stejných polí může ResolverStyle.SMART nahradit příliš vysoké číslo dne posledním dnem měsíce, zatímco ResolverStyle.LENIENT dovoluje přenášet přebytek mezi poli. Pravidla závisí na tom, která pole se kombinují. Například v Java SE 21 mohou lokalizovaná pole WeekFields při sestavování data z týdenních údajů převést 53. týden na 52. týden, pokud rok podle týdenního číslování má jen 52 týdnů, a to i v režimu STRICT.

Nastav styl pomocí withResolverStyle(ResolverStyle.STRICT) a dál používej vrácený formatter: metoda původní formatter nemění. Formatter vytvořený pomocí ofPattern standardně používá SMART. Pro vzor data bez éry použij uuuu-MM-dd: uuuu označuje rok, zatímco yyyy označuje rok v rámci éry. Pokud éra není uvedena, rok v rámci éry nemusí při striktním sestavování data stačit k vytvoření LocalDate.

Příklad přijme 2024-02-29, ale pro 2023-02-29 zachytí DateTimeParseException. Vypíše pevnou zprávu namísto textu výjimky, který závisí na implementaci. Rozsah dokumentace: Java SE 21; běhová prostředí repozitáře a produkce nebyla potvrzena.

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) {
        DateTimeFormatter formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd", Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);

        for (String text : new String[] {"2024-02-29", "2023-02-29"}) {
            try {
                System.out.println(LocalDate.parse(text, formatter));
            } catch (DateTimeParseException ex) {
                System.out.println("Rejected: " + text);
            }
        }
    }
}

Výsledek

2024-02-29
Rejected: 2023-02-29

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