База знанияИзпитен център
BGБългарски
Избери език13

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

Източници