Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

DateTimeFormatter: wzorce, ustawienia regionalne i ścisłe parsowanie

Dobierz wzorzec i ustawienia regionalne do formatu tekstu, a styl rozstrzygania do reguł walidacji daty. Rozróżnij `MM` i `mm` oraz `uuuu` i `yyyy`.

Wersja: Java SE 21

Składnia

java.time.format.DateTimeFormatter (Java SE 21)
static DateTimeFormatter ofPattern(String pattern)
static DateTimeFormatter ofPattern(String pattern, Locale locale)
DateTimeFormatter withLocale(Locale locale)
DateTimeFormatter withResolverStyle(ResolverStyle resolverStyle)

Locale: java.util.Locale
ResolverStyle: java.time.format.ResolverStyle

Statyczna metoda DateTimeFormatter.ofPattern tworzy formater z podanego wzorca. Przeciążenie ofPattern(String) używa domyślnych ustawień regionalnych kategorii FORMAT, a ofPattern(String, Locale) używa ustawień przekazanych jawnie. Oba zaczynają ze stylem SMART. Nieprawidłowy wzorzec powoduje IllegalArgumentException już podczas tworzenia formatera.

Wielkość liter we wzorcu ma znaczenie: dd to dzień miesiąca, MM to numer miesiąca, a mm to minuty. Wzorce dd-MM-uuuu, dd/MM/uuuu i uuuu-MM-dd określają kolejność pól i separatory. uuuu oznacza rok proleptyczny (z rokiem zero), a yyyy rok ery. Przy ścisłym parsowaniu ISO samo yyyy razem z miesiącem i dniem nie wystarczy do utworzenia LocalDate, bo era nie jest domyślna. Dla dat bez ery użyj uuuu.

DateTimeFormatter.withLocale ustawia Locale w zwracanym formaterze. Wpływa m.in. na formatowanie i odczyt nazw miesięcy (MMMM), ale nie przestawia pól ani nie zmienia separatorów jawnego wzorca. Formater jest niemutowalny i bezpieczny wątkowo: zachowaj wynik withLocale lub withResolverStyle, bo oryginał się nie zmienia.

DateTimeFormatter.withResolverStyle steruje drugim etapem parsowania: po odczytaniu pól ze wzorca formater składa z nich datę. Nie zmienia formatowania. Dla dat ISO STRICT odrzuca nieistniejące daty, SMART może skrócić dzień z zakresu 1–31 do ostatniego dnia miesiąca, a LENIENT może przenieść nadmiar dni do kolejnego miesiąca. LocalDate.parse(text, formatter) zgłasza DateTimeParseException, jeśli tekst nie pasuje lub nie można z niego utworzyć daty.

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) {
        LocalDate date = LocalDate.of(2024, 1, 5);
        DateTimeFormatter english = DateTimeFormatter.ofPattern("dd MMMM uuuu", Locale.US);
        DateTimeFormatter french = english.withLocale(Locale.FRANCE);
        System.out.println(date.format(english));
        System.out.println(date.format(french));

        DateTimeFormatter smart = DateTimeFormatter.ofPattern("dd-MM-uuuu", Locale.ROOT);
        DateTimeFormatter strict = smart.withResolverStyle(ResolverStyle.STRICT);
        String invalid = "31-02-2024";
        System.out.println("SMART: " + LocalDate.parse(invalid, smart));
        try {
            System.out.println("STRICT: " + LocalDate.parse(invalid, strict));
        } catch (DateTimeParseException e) {
            System.out.println("STRICT: rejected");
        }
    }
}

Wynik

05 January 2024
05 janvier 2024
SMART: 2024-02-29
STRICT: rejected

Zmiana ustawień regionalnych zmienia nazwę miesiąca, ale nie układ daty. Nazwy zależą od danych regionalnych środowiska uruchomieniowego. Dla `31-02-2024` tryb `SMART` zwraca `2024-02-29`, a `STRICT` odrzuca wejście.

Powiązane lekcje

  • Java · Lekcja 61 · Zaawansowany · Wersja: 2

Źródła