CKTIS / Java
ResolverStyle — ścisłe rozstrzyganie dat
ResolverStyle steruje przekształcaniem odczytanych pól w datę lub czas. Działanie ResolverStyle.STRICT zależy od pól: dla daty kalendarzowej ISO złożonej z roku, miesiąca i dnia styl ten odrzuca 29 lutego w roku nieprzestępnym.
Wersja: Java SE 21 (documentation scope); repository and production runtimes not attested
Składnia
DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)ResolverStyle to typ wyliczeniowy z java.time.format. Parsowanie najpierw odczytuje pola z tekstu, a następnie łączy je w datę lub czas. Styl steruje tym drugim etapem, nie samym dopasowaniem tekstu do wzorca ani formatowaniem wyniku.
Przy rozstrzyganiu daty kalendarzowej ISO z roku, miesiąca i dnia ResolverStyle.STRICT wymaga, by dzień istniał w podanym miesiącu i roku. Dla tych samych pól ResolverStyle.SMART może zastąpić zbyt wysoki numer dnia ostatnim dniem miesiąca, a ResolverStyle.LENIENT pozwala przenosić nadmiar między polami. Reguły zależą od rozstrzyganych pól. Na przykład w Java SE 21 lokalizowane pola WeekFields mogą podczas rozstrzygania daty tygodniowej sprowadzić tydzień 53 do tygodnia 52 w roku tygodniowym liczącym 52 tygodnie, nawet w trybie STRICT.
Ustaw styl przez withResolverStyle(ResolverStyle.STRICT) i zachowaj zwrócony formatter: metoda nie zmienia oryginału. Formatter utworzony przez ofPattern domyślnie używa SMART. We wzorcu daty bez ery używaj uuuu-MM-dd: uuuu oznacza rok, natomiast yyyy oznacza rok ery, który przy ścisłym rozstrzyganiu bez ery może nie wystarczyć do utworzenia LocalDate.
Przykład akceptuje 2024-02-29, ale przechwytuje DateTimeParseException dla 2023-02-29. Wypisuje stały komunikat zamiast zależnego od implementacji tekstu wyjątku. Zakres dokumentacji: Java SE 21; nie potwierdzono środowiska uruchomieniowego repozytorium ani produkcji.
Przykłady
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);
}
}
}
}Wynik
2024-02-29 Rejected: 2023-02-29
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.