CKTIS / Java
ResolverStyle — strogo razreševanje datumov
ResolverStyle določa, kako se razčlenjena polja združijo v datum ali čas. Vedenje sloga ResolverStyle.STRICT je odvisno od polj: pri koledarskem datumu ISO, podanem z letom, mesecem in dnevom, zavrne 29. februar v neprestopnem letu.
Različica: Java SE 21 (documentation scope); repository and production runtimes not attested
Sintaksa
DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)ResolverStyle je enum v java.time.format. Razčlenjevanje najprej prebere polja iz besedila, nato pa jih združi v datum ali čas. Slog nadzira to drugo fazo, ne začetnega ujemanja besedila z vzorcem ali oblikovanja izhoda.
Pri razreševanju koledarskega datuma ISO iz leta, meseca in dneva ResolverStyle.STRICT zahteva, da dan obstaja v navedenem mesecu in letu. Pri istih poljih lahko ResolverStyle.SMART previsoko številko dneva nadomesti z zadnjim dnem v mesecu, medtem ko ResolverStyle.LENIENT dovoljuje prenos presežka med polji. Pravila so odvisna od polj, ki se razrešujejo. V Java SE 21 lahko na primer krajevno prilagojena polja WeekFields pri razreševanju datuma na podlagi tednov spremenijo 53. teden v 52., če ima leto po tedenskem štetju samo 52 tednov, tudi v načinu STRICT.
Slog nastavi z withResolverStyle(ResolverStyle.STRICT) in uporabi vrnjeni formatter: metoda izvirnika ne spremeni. Formatter, ustvarjen z ofPattern, privzeto uporablja SMART. Za vzorec datuma brez dobe uporabi uuuu-MM-dd: uuuu pomeni leto, yyyy pa leto dobe, ki pri strogem razreševanju brez dobe morda ne zadošča za ustvarjanje LocalDate.
Primer sprejme 2024-02-29, za 2023-02-29 pa ujame DateTimeParseException. Izpiše stalno sporočilo namesto besedila izjeme, ki je odvisno od implementacije. Obseg dokumentacije: Java SE 21; izvajalna okolja repozitorija in produkcije niso bila potrjena.
Primeri
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);
}
}
}
}Rezultat
2024-02-29 Rejected: 2023-02-29
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.