CKTIS / Java
DateTimeFormatter: vzory, místní nastavení a striktní parsování
Vzorem a místním nastavením urči podobu textu a režimem vyhodnocení pravidla kontroly data. Rozlišuj `MM` a `mm` i `uuuu` a `yyyy`.
Verze: Java SE 21
Syntaxe
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.ResolverStyleStatická metoda DateTimeFormatter.ofPattern vytváří formátovač podle vzoru. Přetížení ofPattern(String) používá výchozí místní nastavení kategorie FORMAT, zatímco ofPattern(String, Locale) používá zadané nastavení. Obě začínají v režimu SMART. Neplatný vzor vyvolá IllegalArgumentException už při vytváření formátovače.
Ve vzoru záleží na velikosti písmen: dd je den v měsíci, MM je číslo měsíce a mm jsou minuty. dd-MM-uuuu, dd/MM/uuuu a uuuu-MM-dd určují pořadí polí a oddělovače. uuuu je proleptický rok (zahrnuje rok nula), zatímco yyyy je rok v éře. Při striktním parsování ISO nestačí yyyy spolu s měsícem a dnem k vytvoření LocalDate, protože se žádná éra nepředpokládá. Pro data bez éry používej uuuu.
DateTimeFormatter.withLocale nastaví Locale vráceného formátovače. Ovlivňuje text, například úplné názvy měsíců (MMMM), při formátování i parsování. Nemění však pořadí polí ani oddělovače v explicitním vzoru. Formátovače jsou neměnné a bezpečné pro sdílení mezi vlákny: uchovej výsledek withLocale nebo withResolverStyle, protože původní objekt se nemění.
DateTimeFormatter.withResolverStyle řídí druhou fázi parsování: po načtení polí podle vzoru z nich formátovač sestaví datum. Na formátování nemá vliv. U dat ISO režim STRICT odmítá neexistující data, SMART může posunout den v rozmezí 1–31 na poslední den měsíce a LENIENT může přenést přebytečné dny do dalšího měsíce. LocalDate.parse(text, formatter) vyvolá DateTimeParseException, pokud text neodpovídá vzoru nebo z něj nelze sestavit datum.
Příklady
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");
}
}
}
Výsledek
05 January 2024 05 janvier 2024 SMART: 2024-02-29 STRICT: rejected
Místní nastavení mění název měsíce, nikoli strukturu data. Názvy závisí na lokalizačních datech běhového prostředí. Pro `31-02-2024` vrátí `SMART` hodnotu `2024-02-29`, zatímco `STRICT` vstup odmítne.
Související lekce
- Java · Lekce 61 · Pokročilá · Verze: 2