CKTIS / Java
DateTimeFormatter: шаблони, регионални настройки и строг разбор
Избери шаблон и регионални настройки за текста и режим за проверка на датата. Разграничи `MM` от `mm`, както и `uuuu` от `yyyy`.
Версия: Java SE 21
Синтаксис
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Статичният метод DateTimeFormatter.ofPattern създава форматер по шаблон. Вариантът ofPattern(String) използва регионалните настройки по подразбиране за категорията FORMAT, а ofPattern(String, Locale) използва изрично подадените настройки. И двата започват в режим SMART. Невалиден шаблон предизвиква IllegalArgumentException още при създаването на форматера.
Главните и малките букви в шаблона имат различно значение: dd е ден от месеца, MM е номер на месеца, а mm означава минути. dd-MM-uuuu, dd/MM/uuuu и uuuu-MM-dd определят реда на полетата и разделителите. uuuu означава пролептична година (включително година нула), а yyyy — година в рамките на ера. При строг разбор на ISO дата yyyy заедно само с месец и ден не е достатъчно за получаване на LocalDate, защото не се приема ера по подразбиране. За дати без ера използвай uuuu.
DateTimeFormatter.withLocale задава Locale на върнатия форматер. Това влияе на текста, например на пълните имена на месеците (MMMM), при форматиране и разбор, но не променя реда на полетата или разделителите в изрично зададен шаблон. Форматерите са неизменяеми и могат безопасно да се споделят между нишки: запази резултата от withLocale или withResolverStyle, защото оригиналът не се променя.
DateTimeFormatter.withResolverStyle управлява втория етап на разбора: след прочитането на полетата според шаблона форматерът ги обединява в дата. Това не променя форматирането. За ISO дати STRICT отхвърля несъществуващи дати, SMART може да ограничи ден от диапазона 1–31 до последния ден на месеца, а LENIENT може да прехвърли излишните дни в следващия месец. LocalDate.parse(text, formatter) хвърля DateTimeParseException, ако текстът не съответства на шаблона или не може да се получи дата.
Примери
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");
}
}
}
Резултат
05 January 2024 05 janvier 2024 SMART: 2024-02-29 STRICT: rejected
Регионалните настройки променят името на месеца, но не и подредбата на датата. Имената зависят от данните за локализация в средата за изпълнение. За `31-02-2024` режимът `SMART` връща `2024-02-29`, а `STRICT` отхвърля входа.
Свързани уроци
- Java · Урок 61 · Напреднало · Версия: 2