CKTIS / Java
ResolverStyle — striktné zostavovanie dátumu z polí
ResolverStyle určuje, ako sa z načítaných polí zostaví dátum alebo čas. Správanie ResolverStyle.STRICT závisí od polí: pri zostavovaní kalendárneho dátumu ISO z roka, mesiaca a dňa tento štýl odmietne 29. február v nepriestupnom roku.
Verzia: Java SE 21 (documentation scope); repository and production runtimes not attested
Syntax
DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)ResolverStyle je výčtový typ v java.time.format. Pri parsovaní sa najprv načítajú hodnoty polí z textu. V druhej fáze sa z týchto hodnôt zostaví dátum alebo čas. Štýl riadi túto druhú fázu, nie počiatočné porovnávanie textu so vzorom ani formátovanie výstupu.
Pri zostavovaní kalendárneho dátumu ISO z roka, mesiaca a dňa ResolverStyle.STRICT vyžaduje, aby deň existoval v danom mesiaci a roku. Pri rovnakých poliach môže ResolverStyle.SMART nahradiť príliš vysoké číslo dňa posledným dňom mesiaca, zatiaľ čo ResolverStyle.LENIENT umožňuje prenášať prebytok medzi poľami. Pravidlá závisia od toho, ktoré polia sa kombinujú. Napríklad v Java SE 21 môžu lokalizované polia WeekFields pri zostavovaní dátumu z týždenných údajov previesť 53. týždeň na 52. týždeň, ak má rok podľa týždenného číslovania iba 52 týždňov, a to aj v režime STRICT.
Nastav štýl pomocou withResolverStyle(ResolverStyle.STRICT) a ďalej používaj vrátený formatter: metóda pôvodný formatter nemení. Formatter vytvorený pomocou ofPattern štandardne používa SMART. Pre vzor dátumu bez éry použi uuuu-MM-dd: uuuu označuje rok, zatiaľ čo yyyy označuje rok v rámci éry. Ak éra nie je uvedená, rok v rámci éry nemusí pri striktnom zostavovaní dátumu stačiť na vytvorenie LocalDate.
Príklad prijme 2024-02-29, ale pre 2023-02-29 zachytí DateTimeParseException. Vypíše pevnú správu namiesto textu výnimky závislého od implementácie. Rozsah dokumentácie: Java SE 21; behové prostredia repozitára a produkcie neboli potvrdené.
Prí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ýsledok
2024-02-29 Rejected: 2023-02-29
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.