Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła