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

CKTIS / Java

ResolverStyle — стриктно разрешаване на дати

ResolverStyle определя как анализираните полета се комбинират в дата или час. Поведението на ResolverStyle.STRICT зависи от полетата: при календарна дата по ISO, зададена чрез година, месец и ден, този стил отхвърля 29 февруари в невисокосна година.

Версия: Java SE 21 (documentation scope); repository and production runtimes not attested

Синтаксис

DateTimeFormatter.ofPattern("uuuu-MM-dd", Locale.ROOT).withResolverStyle(ResolverStyle.STRICT)

ResolverStyle е enum в java.time.format. При анализирането първо се прочитат полетата от текста, а след това се комбинират в дата или час. Стилът управлява този втори етап, а не първоначалното съпоставяне на текста с шаблон или форматирането на резултата.

При разрешаване на календарна дата по ISO от година, месец и ден ResolverStyle.STRICT изисква денят да съществува в посочените месец и година. За същите полета ResolverStyle.SMART може да замени прекалено голям номер на деня с последния ден на месеца, докато ResolverStyle.LENIENT позволява прехвърляне на излишъка между полетата. Правилата зависят от полетата, които се разрешават. Например в Java SE 21 при разрешаване на дата, зададена чрез седмица, зависещите от регионалните настройки полета на WeekFields могат да сведат 53-тата седмица до 52-рата, ако годината при броене по седмици има само 52 седмици, дори в режим STRICT.

Задай стила с withResolverStyle(ResolverStyle.STRICT) и използвай върнатия formatter: методът не променя оригинала. Formatter, създаден с ofPattern, използва SMART по подразбиране. За шаблон на дата без ера използвай uuuu-MM-dd: uuuu означава година, докато yyyy означава година от ерата, която може да не е достатъчна за създаване на LocalDate при стриктно разрешаване без ера.

Примерът приема 2024-02-29, но улавя DateTimeParseException за 2023-02-29. Той извежда фиксирано съобщение вместо текст на изключение, който зависи от имплементацията. Обхват на документацията: Java SE 21; средите за изпълнение на хранилището и продукцията не са потвърдени.

Примери

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) {
        DateTimeFormatter formatter = DateTimeFormatter
                .ofPattern("uuuu-MM-dd", Locale.ROOT)
                .withResolverStyle(ResolverStyle.STRICT);

        for (String text : new String[] {"2024-02-29", "2023-02-29"}) {
            try {
                System.out.println(LocalDate.parse(text, formatter));
            } catch (DateTimeParseException ex) {
                System.out.println("Rejected: " + text);
            }
        }
    }
}

Резултат

2024-02-29
Rejected: 2023-02-29

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници