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.ResolverStyleStatyczna 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