CKTIS / Java
ResolverStyle — strogo razrješavanje datuma
ResolverStyle određuje kako se raščlanjena polja spajaju u datum ili vrijeme. Ponašanje stila ResolverStyle.STRICT ovisi o poljima: pri razrješavanju kalendarskog datuma ISO zadanog godinom, mjesecom i danom taj stil odbija 29. veljače u neprijestupnoj godini.
Verzija: 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 u java.time.format. Raščlanjivanje najprije čita polja iz teksta, a zatim ih spaja u datum ili vrijeme. Stil upravlja tom drugom fazom, a ne početnim podudaranjem teksta s uzorkom ili oblikovanjem izlaza.
Pri razrješavanju kalendarskog datuma ISO iz godine, mjeseca i dana ResolverStyle.STRICT zahtijeva da dan postoji u navedenom mjesecu i godini. Za ista polja ResolverStyle.SMART može previsok broj dana zamijeniti posljednjim danom mjeseca, dok ResolverStyle.LENIENT dopušta prijenos viška između polja. Pravila ovise o poljima koja se razrješavaju. Primjerice, u verziji Java SE 21 lokalizirana polja WeekFields pri razrješavanju datuma na temelju tjedana mogu svesti 53. tjedan na 52. ako godina prema tjednom računanju ima samo 52 tjedna, čak i u načinu STRICT.
Postavi stil pomoću withResolverStyle(ResolverStyle.STRICT) i nastavi upotrebljavati vraćeni formatter: metoda ne mijenja izvorni. Formatter izrađen pomoću ofPattern prema zadanim postavkama koristi SMART. Za uzorak datuma bez ere upotrijebi uuuu-MM-dd: uuuu označava godinu, dok yyyy označava godinu ere, koja pri strogom razrješavanju bez ere možda neće biti dovoljna za stvaranje LocalDate.
Primjer prihvaća 2024-02-29, ali za 2023-02-29 hvata DateTimeParseException. Ispisuje fiksnu poruku umjesto teksta iznimke koji ovisi o implementaciji. Opseg dokumentacije: Java SE 21; okruženja izvođenja u repozitoriju i produkciji nisu potvrđena.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.