Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

DateTimeFormatter — formatowanie i parsowanie dat

DateTimeFormatter zamienia daty i czas na tekst oraz parsuje tekst. Poznaj wzorce, jawne ustawienie Locale i ścisłą walidację, a także różnice MM versus mm oraz uuuu versus yyyy.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

DateTimeFormatter.ofPattern("uuuu-MM-dd HH:mm").withLocale(Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)

DateTimeFormatter jest niemutowalny i bezpieczny wątkowo. DateTimeFormatter.ofPattern tworzy formatter ze wzorca; można go wielokrotnie używać do formatowania i parsowania.

W rozróżnieniu MM versus mm: MM oznacza dwucyfrowy miesiąc, a mm — dwucyfrowe minuty. uuuu versus yyyy: uuuu oznacza rok proleptyczny, a yyyy — rok ery. Przy ścisłym parsowaniu dat ISO bez ery używaj uuuu; samo yyyy nie wystarcza do wyznaczenia daty.

DateTimeFormatter.withLocale zwraca formatter z wybranym Locale, wpływającym np. na nazwy miesięcy. DateTimeFormatter.withResolverStyle również nie zmienia oryginału. Wybierz ResolverStyle.STRICT, aby odrzucać niepoprawne daty. Domyślny dla ofPattern tryb SMART może skorygować dzień do końca miesiąca, np. 2023-02-29 do 2023-02-28.

Przykład przyjmuje 2024-02-29 09:07, lecz odrzuca 2023-02-29 09:07. STRICT steruje rozstrzyganiem pól podczas parsowania, nie formatowaniem.

Przykłady

import java.time.LocalDateTime;
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 HH:mm")
                .withLocale(Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);

        LocalDateTime value = LocalDateTime.parse("2024-02-29 09:07", formatter);
        System.out.println(value.format(formatter));

        try {
            LocalDateTime.parse("2023-02-29 09:07", formatter);
            throw new AssertionError("Expected rejection");
        } catch (DateTimeParseException ex) {
            System.out.println("Invalid date rejected");
        }
    }
}

Wynik

2024-02-29 09:07
Invalid date rejected

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła