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.