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.