Класс DateTimeFormatter

Возвращает неизменяемый форматтер, способный форматировать и анализировать расширенный локальный формат даты ISO-8601. Формат состоит из следующих элементов:

• Четыре или более цифр для поля year. Годы в диапазоне от 0000 до 9999 дополняются нулями слева, чтобы получить четыре цифры. Перед годами за пределами этого диапазона ставится положительный или отрицательный знак.
• Дефис ('HYPHEN-MINUS', U+002D)
• Две цифры для поля month-of-year. Значение дополняется нулём слева, чтобы получить две цифры.
• Дефис ('HYPHEN-MINUS', U+002D)
• Две цифры для поля day-of-month. Значение дополняется нулём слева, чтобы получить две цифры.

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать расширенный формат даты ISO-8601 со смещением. Формат состоит из следующих элементов:

• ISO_LOCAL_DATE
• offset ID. Если смещение содержит секунды, они также будут обработаны, хотя это не предусмотрено стандартом ISO-8601. Разбор смещения выполняется в нестрогом режиме, поэтому минуты и секунды могут отсутствовать. Регистр символов при разборе не учитывается.

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать расширенный формат даты ISO-8601. Формат состоит из следующих элементов:

• ISO_LOCAL_DATE
• Если смещение недоступно, формат завершён.
• offset ID. Если смещение содержит секунды, они также будут обработаны, хотя это не предусмотрено стандартом ISO-8601. Разбор смещения выполняется в нестрогом режиме, поэтому минуты и секунды могут отсутствовать. Регистр символов при разборе не учитывается.

Поскольку этот форматтер содержит необязательный элемент, для разбора может потребоваться использовать parseBest(CharSequence, TemporalQuery...).

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать расширенный локальный формат времени ISO-8601. Формат состоит из следующих элементов:

• Две цифры для поля hour-of-day. Значение дополняется нулём слева, чтобы получить две цифры.
• Двоеточие
• Две цифры для поля minute-of-hour. Значение дополняется нулём слева, чтобы получить две цифры.
• Если секунды недоступны, формат завершён.
• Двоеточие
• Две цифры для поля second-of-minute. Значение дополняется нулём слева, чтобы получить две цифры.
• Если наносекунды равны нулю или недоступны, формат завершён.
• Десятичный разделитель
• От одной до девяти цифр для поля nano-of-second. Выводится столько цифр, сколько необходимо.

Возвращаемый форматтер не переопределяет хронологию или часовой пояс. Он использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать расширенный формат времени ISO-8601 со смещением. Формат состоит из следующих элементов:

• ISO_LOCAL_TIME
• offset ID. Если смещение содержит секунды, они также будут обработаны, хотя это не предусмотрено стандартом ISO-8601. Разбор смещения выполняется в нестрогом режиме, поэтому минуты и секунды могут отсутствовать. Регистр символов при разборе не учитывается.

Возвращаемый форматтер не переопределяет хронологию или часовой пояс. Он использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать расширенный формат времени ISO-8601 со смещением. Формат состоит из следующих элементов:

• ISO_LOCAL_TIME
• Если смещение недоступно, формат завершён.
• offset ID. Если смещение содержит секунды, они также будут обработаны, хотя это не предусмотрено стандартом ISO-8601. Разбор смещения выполняется в нестрогом режиме, поэтому минуты и секунды могут отсутствовать. Регистр символов при разборе не учитывается.

Поскольку этот форматтер содержит необязательный элемент, для разбора может потребоваться использовать parseBest(CharSequence, TemporalQuery...).

Возвращаемый форматтер не переопределяет хронологию или часовой пояс. Он использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать расширенный формат даты и времени ISO-8601 со смещением. Формат состоит из следующих элементов:

• ISO_LOCAL_DATE
• Буква 'T'. Регистр символов при разборе не учитывается.
• ISO_LOCAL_TIME

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать расширенный формат даты и времени ISO-8601 со смещением. Формат состоит из следующих элементов:

• ISO_LOCAL_DATE_TIME
• offset ID. Если смещение содержит секунды, они также будут обработаны, хотя это не предусмотрено стандартом ISO-8601. Разбор смещения выполняется в нестрогом режиме, поэтому минуты и секунды могут отсутствовать. Регистр символов при разборе не учитывается.

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать формат, расширяющий расширенный формат даты и времени ISO-8601 со смещением за счёт добавления часового пояса. Часть в квадратных скобках не входит в стандарт ISO-8601. Формат состоит из следующих элементов:

• ISO_OFFSET_DATE_TIME
• Если идентификатор часового пояса недоступен или является ZoneOffset, формат завершён.
• Открывающая квадратная скобка '['.
• zone ID. Эта часть не входит в стандарт ISO-8601. При разборе учитывается регистр символов.
• Закрывающая квадратная скобка ']'.

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать расширенный локальный формат даты и времени ISO-8601 или формат со смещением, а также расширенный формат, не входящий в ISO, с указанием часового пояса. Формат состоит из следующих элементов:

• ISO_LOCAL_DATE_TIME
• Если смещение недоступно для форматирования или разбора, формат завершён.
• offset ID. Если смещение содержит секунды, они также будут обработаны, хотя это не предусмотрено стандартом ISO-8601. Разбор смещения выполняется в нестрогом режиме, поэтому минуты и секунды могут отсутствовать.
• Если идентификатор часового пояса недоступен или является ZoneOffset, формат завершён.
• Открывающая квадратная скобка '['.
• zone ID. Эта часть не входит в стандарт ISO-8601. При разборе учитывается регистр символов.
• Закрывающая квадратная скобка ']'.

Поскольку этот форматтер содержит необязательный элемент, для разбора может потребоваться использовать parseBest(CharSequence, TemporalQuery...).

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать расширенный формат порядковой даты ISO-8601. Формат состоит из следующих элементов:

• Четыре или более цифр для поля year. Годы в диапазоне от 0000 до 9999 дополняются нулями слева, чтобы получить четыре цифры. Перед годами за пределами этого диапазона ставится положительный или отрицательный знак.
• Дефис ('HYPHEN-MINUS', U+002D)
• Три цифры для поля day-of-year. Значение дополняется нулями слева, чтобы получить три цифры.
• Если смещение недоступно для форматирования или разбора, формат завершён.
• offset ID. Если смещение содержит секунды, они также будут обработаны, хотя это не предусмотрено стандартом ISO-8601. Разбор смещения выполняется в нестрогом режиме, поэтому минуты и секунды могут отсутствовать. Регистр символов при разборе не учитывается.

Поскольку этот форматтер содержит необязательный элемент, для разбора может потребоваться использовать parseBest(CharSequence, TemporalQuery...).

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать расширенный формат даты по неделям ISO-8601. Формат состоит из следующих элементов:

• Четыре или более цифр для поля week-based-year. Годы в диапазоне от 0000 до 9999 дополняются нулями слева, чтобы получить четыре цифры. Перед годами за пределами этого диапазона ставится положительный или отрицательный знак.
• Дефис ('HYPHEN-MINUS', U+002D)
• Буква 'W'. Регистр символов при разборе не учитывается.
• Две цифры для поля week-of-week-based-year. Значение дополняется нулём слева, чтобы получить три цифры.
• Дефис ('HYPHEN-MINUS', U+002D)
• Одна цифра для поля day-of-week. Значение задаётся в диапазоне от понедельника (1) до воскресенья (7).
• Если смещение недоступно для форматирования или разбора, формат завершён.
• offset ID. Если смещение содержит секунды, они также будут обработаны, хотя это не предусмотрено стандартом ISO-8601. Разбор смещения выполняется в нестрогом режиме, поэтому минуты и секунды могут отсутствовать. Регистр символов при разборе не учитывается.

Поскольку этот форматтер содержит необязательный элемент, для разбора может потребоваться использовать parseBest(CharSequence, TemporalQuery...).

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать формат мгновения ISO-8601. При форматировании к мгновению всегда добавляется суффикс 'Z', указывающий на UTC. Секунды всегда выводятся. Для наносекунд выводится ноль, три, шесть или девять цифр, в зависимости от необходимости. При разборе для обработки смещения будет использоваться нестрогий режим метода appendOffset("+HH", "Z"); при необходимости мгновение будет преобразовано в UTC. Требуется, чтобы время содержало как минимум поле секунд. Разбираются дробные секунды от нуля до девяти знаков. Локализованный десятичный формат не используется.

Это специальный форматтер, предназначенный для представления в удобочитаемом виде значения Instant. Класс Instant предназначен для представления только точки во времени и внутренне хранит значение в наносекундах относительно фиксированной эпохи 1970-01-01Z. Поэтому Instant нельзя отформатировать как дату или время без указания часового пояса. Этот форматтер позволяет отформатировать Instant, выполняя подходящее преобразование с помощью ZoneOffset.UTC.

Формат состоит из следующего элемента:

• ISO_OFFSET_DATE_TIME, в котором мгновение преобразуется из полей ChronoField.INSTANT_SECONDS и ChronoField.NANO_OF_SECOND с использованием смещения UTC. Регистр символов при разборе не учитывается.

Возвращаемый форматтер не переопределяет хронологию или часовой пояс. Он использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать базовый локальный формат даты ISO-8601. Формат состоит из следующих элементов:

• Четыре цифры для поля year. Поддерживаются только годы в диапазоне от 0000 до 9999.
• Две цифры для поля month-of-year. Значение дополняется нулём слева, чтобы получить две цифры.
• Две цифры для поля day-of-month. Значение дополняется нулём слева, чтобы получить две цифры.
• Если смещение недоступно для форматирования или разбора, формат завершён.
• offset ID без двоеточий. Если смещение содержит секунды, они также будут обработаны, хотя это не предусмотрено стандартом ISO-8601. Разбор смещения выполняется в нестрогом режиме, поэтому минуты и секунды могут отсутствовать. Регистр символов при разборе не учитывается.

Поскольку этот форматтер содержит необязательный элемент, для разбора может потребоваться использовать parseBest(CharSequence, TemporalQuery...).

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения STRICT.

Возвращает неизменяемый форматтер, способный форматировать и анализировать большую часть формата RFC-1123. RFC-1123 обновляет RFC-822, заменяя двузначное представление года четырёхзначным. Эта реализация требует, чтобы год состоял из четырёх цифр. Кроме того, эта реализация не обрабатывает названия североамериканских часовых поясов и военных часовых поясов, а поддерживает только 'GMT' и числовые значения смещения.

Формат состоит из следующих элементов:

• Если день недели недоступен для форматирования или разбора, переходите к дню месяца.
• Трёхбуквенное обозначение day-of-week на английском языке.
• Запятая
• Пробел
• Одна или две цифры для поля day-of-month.
• Пробел
• Трёхбуквенное обозначение month-of-year на английском языке.
• Пробел
• Четыре цифры для поля year. Поддерживаются только годы в диапазоне от 0000 до 9999.
• Пробел
• Две цифры для поля hour-of-day. Значение дополняется нулём слева, чтобы получить две цифры.
• Двоеточие
• Две цифры для поля minute-of-hour. Значение дополняется нулём слева, чтобы получить две цифры.
• Если секунды недоступны, переходите к следующему пробелу.
• Двоеточие
• Две цифры для поля second-of-minute. Значение дополняется нулём слева, чтобы получить две цифры.
• Пробел
• offset ID без двоеточий и секунд. Для нулевого смещения используется "GMT". Названия североамериканских часовых поясов и военных часовых поясов не обрабатываются.

При разборе регистр символов не учитывается.

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения SMART.

Этот метод создаёт форматтер на основе простого шаблона из букв и символов, описанного в документации класса. Например, d MMM uuuu отформатирует 2011-12-03 как '3 Dec 2011'.

Форматтер будет использовать default FORMAT locale. Это можно изменить с помощью withLocale(Locale) для возвращённого форматтера. Также можно использовать вариант этого метода ofPattern(String, Locale).

Возвращаемый форматтер не переопределяет хронологию или часовой пояс. Он использует стиль разрешения SMART.

Этот метод создаёт форматтер на основе простого шаблона из букв и символов, описанного в документации класса. Например, d MMM uuuu отформатирует 2011-12-03 как '3 Dec 2011'.

Форматтер будет использовать указанную локаль. Её можно изменить с помощью withLocale(Locale) для возвращённого форматтера.

Возвращаемый форматтер не переопределяет хронологию или часовой пояс. Он использует стиль разрешения SMART.

Возвращает форматтер, который форматирует или анализирует дату. Точный шаблон формата зависит от локали.

Локаль определяется форматтером. Форматтер, непосредственно возвращаемый этим методом, использует default FORMAT locale. Локаль можно задать с помощью withLocale(Locale) для результата этого метода.

Обратите внимание, что локализованный шаблон ищется отложенно. Этот DateTimeFormatter хранит требуемый стиль и локаль, а нужный шаблон ищется по мере необходимости.

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения SMART.

Возвращает форматтер, который форматирует или анализирует время. Точный шаблон формата зависит от локали.

Локаль определяется форматтером. Форматтер, непосредственно возвращаемый этим методом, использует default FORMAT locale. Локаль можно задать с помощью withLocale(Locale) для результата этого метода.

Обратите внимание, что локализованный шаблон ищется отложенно. Этот DateTimeFormatter хранит требуемый стиль и локаль, а нужный шаблон ищется по мере необходимости.

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения SMART. Для стилей FULL и LONG обычно требуется часовой пояс. При форматировании с использованием этих стилей должен быть доступен ZoneId, заданный с помощью ZonedDateTime или withZone(ZoneId).

Возвращает форматтер, который форматирует или анализирует дату и время. Точный шаблон формата зависит от локали.

Локаль определяется форматтером. Форматтер, непосредственно возвращаемый этим методом, использует default FORMAT locale. Локаль можно задать с помощью withLocale(Locale) для результата этого метода.

Обратите внимание, что локализованный шаблон ищется отложенно. Этот DateTimeFormatter хранит требуемый стиль и локаль, а нужный шаблон ищется по мере необходимости.

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения SMART. Для стилей FULL и LONG обычно требуется часовой пояс. При форматировании с использованием этих стилей должен быть доступен ZoneId, заданный с помощью ZonedDateTime или withZone(ZoneId).

Возвращает форматтер, который форматирует или анализирует дату и время. Точный шаблон формата зависит от локали.

Локаль определяется форматтером. Форматтер, непосредственно возвращаемый этим методом, использует default FORMAT locale. Локаль можно задать с помощью withLocale(Locale) для результата этого метода.

Обратите внимание, что локализованный шаблон ищется отложенно. Этот DateTimeFormatter хранит требуемый стиль и локаль, а нужный шаблон ищется по мере необходимости.

Возвращаемый форматтер использует хронологию ISO, чтобы даты в других календарных системах преобразовывались правильно. Он не переопределяет часовой пояс и использует стиль разрешения SMART. Для стилей FULL и LONG обычно требуется часовой пояс. При форматировании с использованием этих стилей должен быть доступен ZoneId, заданный с помощью ZonedDateTime или withZone(ZoneId).

     "G{0,5}" +        // Era
     "y*" +            // Year
     "Q{0,5}" +        // Quarter
     "M{0,5}" +        // Month
     "w*" +            // Week of Week Based Year
     "E{0,5}" +        // Day of Week
     "d{0,2}" +        // Day of Month
     "B{0,5}" +        // Period/AmPm of Day
     "[hHjC]{0,2}" +   // Hour of Day/AmPm (refer to LDML for 'j' and 'C')
     "m{0,2}" +        // Minute of Hour
     "s{0,2}" +        // Second of Minute
     "[vz]{0,4}"       // Zone

Сопоставление запрошенного шаблона с наиболее близким из доступных локализованных форматов определено в спецификации Unicode LDML. Например, форматтер, созданный по запрошенному шаблону yMMM, преобразует дату '2020-06-16' в 'Jun 2020' для US locale.

Локаль определяется форматтером. Форматтер, непосредственно возвращаемый этим методом, использует default FORMAT locale. Локаль можно задать с помощью withLocale(Locale) для результата этого метода.

Возвращаемый форматтер не имеет переопределенной зоны. Он использует стиль разрешения SMART.

Возвращает singleton-запрос, предоставляющий доступ к дополнительной информации о разборе. Запрос всегда возвращает ненулевой период; вместо null возвращается нулевой период.

Есть две ситуации, в которых этот запрос может вернуть ненулевой период.

• Если ResolverStyle имеет значение LENIENT и время разбирается без даты, полный результат разбора состоит из LocalTime и избыточного Period в днях.
• Если ResolverStyle имеет значение SMART и время разбирается без даты, причем время равно 24:00:00, полный результат разбора состоит из LocalTime со значением 00:00:00 и избыточного Period длительностью один день.

В обоих случаях, если разбирается полная дата ChronoLocalDateTime или Instant, избыточные дни добавляются к части даты. В результате этот запрос вернет нулевой период.

Поведение SMART обрабатывает распространенное значение «конец дня» 24:00. Обработка в режиме LENIENT также дает тот же результат:

 Text to parse        Parsed object                         Excess days
 "2012-12-03T00:00"   LocalDateTime.of(2012, 12, 3, 0, 0)   ZERO
 "2012-12-03T24:00"   LocalDateTime.of(2012, 12, 4, 0, 0)   ZERO
 "00:00"              LocalTime.of(0, 0)                    ZERO
 "24:00"              LocalTime.of(0, 0)                    Period.ofDays(1)

 TemporalAccessor parsed = formatter.parse(str);
 LocalTime time = parsed.query(LocalTime::from);
 Period extraDays = parsed.query(DateTimeFormatter.parsedExcessDays());

Возвращает singleton-запрос, предоставляющий доступ к дополнительной информации о разборе. Запрос всегда возвращает ненулевое логическое значение: true, если при разборе был обнаружен високосный секундный интервал, и false в противном случае.

При разборе момента времени обрабатывается особое время «високосной секунды» — '23:59:60'. Високосные секунды наступают в '23:59:60' в часовом поясе UTC, но в других часовых поясах — в другое местное время. Чтобы избежать возможной неоднозначности, обработка високосных секунд ограничена методом DateTimeFormatterBuilder.appendInstant(), поскольку этот метод всегда разбирает момент времени со смещением часового пояса UTC.

Если получено время '23:59:60', выполняется простое преобразование: секунды минуты со значением 60 заменяются на 59. Этот запрос можно применить к результату разбора, чтобы определить, была ли выполнена корректировка високосной секунды. Запрос вернет true, если значение было скорректировано для удаления високосной секунды, и false в противном случае. Обратите внимание, что применение механизма сглаживания високосных секунд, например UTC-SLS, является обязанностью приложения:

 TemporalAccessor parsed = formatter.parse(str);
 Instant instant = parsed.query(Instant::from);
 if (parsed.query(DateTimeFormatter.parsedLeapSecond())) {
   // validate leap-second is correct and apply correct smoothing
 }

Она используется для поиска элементов форматтера, требующих локализации, например текста или локализованного шаблона.

Она используется для поиска элементов форматтера, требующих локализации, например текста или локализованного шаблона.

Локаль сохраняется в переданном виде, без дополнительной обработки. Если локаль содержит расширения Unicode, они могут использоваться при последующей обработке текста. Чтобы задать хронологию, часовой пояс и десятичный стиль из расширений Unicode, см. localizedBy().

Этот экземпляр неизменяем, и вызов данного метода на него не влияет.

Метод используется для поиска элементов форматтера, требующих локализации, например текста или локализованного шаблона. Если локаль содержит расширения Unicode "ca" (календарь), "nu" (система счисления), "rg" (переопределение региона) и/или "tz" (часовой пояс), переопределяются хронология, система счисления и/или зона. Если указаны оба расширения — "ca" и "rg", хронология из расширения "ca" имеет приоритет над неявно заданной расширением "rg". То же относится к расширению "nu".

В отличие от метода withLocale, вызов этого метода может привести к созданию другого форматтера в зависимости от порядка вызова методов withXXXX() в цепочке.

Этот экземпляр неизменяем, и вызов данного метода на него не влияет.

Этот экземпляр неизменяем, и вызов данного метода на него не влияет.

Возвращает переопределенную хронологию, используемую для преобразования дат. По умолчанию форматтер не имеет переопределенной хронологии и возвращает null. Дополнительные сведения о переопределении см. в разделе withChronology(Chronology).

Возвращает форматтер с состоянием, аналогичным состоянию этого форматтера, но с заданной переопределяющей хронологией. По умолчанию форматтер не имеет переопределенной хронологии и возвращает null.

Добавление переопределения влияет на любую форматируемую или разбираемую дату.

При форматировании, если временной объект содержит дату, она будет преобразована в дату переопределяющей хронологии. Наличие даты во временном объекте определяется путем запроса поля EPOCH_DAY. Любые значения времени или зоны сохраняются без изменений, если они не переопределены.

Если временной объект не содержит дату, но содержит одно или несколько полей даты ChronoField, выбрасывается исключение DateTimeException. Во всех остальных случаях переопределяющая хронология добавляется к временному объекту, заменяя любую предыдущую хронологию, но не изменяя дату и время.

При разборе необходимо учитывать два отдельных случая. Если хронология была разобрана непосредственно из текста, возможно, потому что использовался метод DateTimeFormatterBuilder.appendChronologyId(), эта переопределяющая хронология не действует. Если зона не была разобрана, эта переопределяющая хронология будет использоваться для интерпретации значений ChronoField в качестве даты согласно правилам разрешения дат данной хронологии.

Этот экземпляр неизменяем, и вызов данного метода на него не влияет.

Возвращает переопределенную зону, используемую для преобразования моментов времени. По умолчанию форматтер не имеет переопределенной зоны и возвращает null. Дополнительные сведения о переопределении см. в разделе withZone(ZoneId).

Возвращает форматтер с состоянием, аналогичным состоянию этого форматтера, но с заданной переопределяющей зоной. По умолчанию форматтер не имеет переопределенной зоны и возвращает null.

Добавление переопределения влияет на любой форматируемый или разбираемый момент времени.

При форматировании, если временной объект содержит момент времени, он будет преобразован в дату-время с часовым поясом с использованием переопределяющей зоны. Наличие момента времени во временном объекте определяется путем запроса поля INSTANT_SECONDS. Если входные данные содержат хронологию, она сохраняется, если не переопределена. Если входные данные не содержат хронологию, например Instant, используется ISO-хронология.

Если временной объект не содержит момента времени, но содержит смещение, выполняется дополнительная проверка. Если нормализованная переопределяющая зона является смещением, отличающимся от смещения временного объекта, выбрасывается исключение DateTimeException. Во всех остальных случаях переопределяющая зона добавляется к временному объекту, заменяя любую предыдущую зону, но не изменяя дату и время.

При разборе необходимо учитывать два отдельных случая. Если зона была разобрана непосредственно из текста, возможно, потому что использовался метод DateTimeFormatterBuilder.appendZoneId(), эта переопределяющая зона не действует. Если зона не была разобрана, переопределяющая зона будет включена в результат разбора, где ее можно использовать для построения моментов времени и даты-времени.

Этот экземпляр неизменяем, и вызов данного метода на него не влияет.

Возвращает стиль разрешения, используемый на втором этапе разбора, когда поля преобразуются в даты и время. По умолчанию форматтер использует стиль разрешения SMART. Дополнительные сведения см. в разделе withResolverStyle(ResolverStyle).

Возвращает форматтер с состоянием, аналогичным состоянию этого форматтера, но с заданным стилем разрешения. По умолчанию форматтер использует стиль разрешения SMART.

Изменение стиля разрешения влияет только на разбор. Разбор текстовой строки выполняется в два этапа. На первом этапе выполняется базовый разбор текста согласно полям, добавленным в построитель. На втором этапе разобранные пары «поле — значение» преобразуются в объекты даты и/или времени. Стиль разрешения определяет, как выполняется второй этап — разрешение. Дополнительные сведения о доступных параметрах см. в разделе ResolverStyle.

Этот экземпляр неизменяем, и вызов данного метода на него не влияет.

Возвращает поля разрешения, используемые на втором этапе разбора, когда поля преобразуются в даты и время. По умолчанию форматтер не имеет полей разрешения и поэтому возвращает null. Дополнительные сведения см. в разделе withResolverFields(Set).

Возвращает форматтер с состоянием, аналогичным состоянию этого форматтера, но с заданными полями разрешения. По умолчанию форматтер не имеет полей разрешения.

Изменение полей разрешения влияет только на разбор. Разбор текстовой строки выполняется в два этапа. На первом этапе выполняется базовый разбор текста согласно полям, добавленным в построитель. На втором этапе разобранные пары «поле — значение» преобразуются в объекты даты и/или времени. Поля разрешения используются для фильтрации пар «поле — значение» между первым и вторым этапами.

Это можно использовать для выбора одного из двух или более способов разрешения даты или времени. Например, если форматтер включает год, месяц, день месяца и день года, дату можно разрешить двумя способами. Вызов этого метода с аргументами YEAR и DAY_OF_YEAR обеспечит разрешение даты с использованием года и дня года; это означает, что месяц и день месяца будут игнорироваться на этапе разрешения.

Аналогичным образом этот метод можно использовать, чтобы игнорировать второстепенные поля, которые иначе подвергались бы перекрестной проверке. Например, если форматтер включает год, месяц, день месяца и день недели, дату можно разрешить только одним способом, но разобранное значение дня недели будет сверяться с разрешенной датой. Вызов этого метода с аргументами YEAR, MONTH_OF_YEAR и DAY_OF_MONTH обеспечит правильное разрешение даты без перекрестной проверки дня недели.

С точки зрения реализации этот метод работает следующим образом. Результат этапа разбора можно рассматривать как отображение полей в значения. Этот метод фильтрует такое отображение между первым и вторым этапами, удаляя все поля, кроме указанных в аргументах метода.

Этот экземпляр неизменяем, и вызов данного метода на него не влияет.

Возвращает форматтер с состоянием, аналогичным состоянию этого форматтера, но с заданными полями разрешения. По умолчанию форматтер не имеет полей разрешения.

Изменение полей разрешения влияет только на разбор. Разбор текстовой строки выполняется в два этапа. На первом этапе выполняется базовый разбор текста согласно полям, добавленным в построитель. На втором этапе разобранные пары «поле — значение» преобразуются в объекты даты и/или времени. Поля разрешения используются для фильтрации пар «поле — значение» между первым и вторым этапами.

Это можно использовать для выбора одного из двух или более способов разрешения даты или времени. Например, если форматтер включает год, месяц, день месяца и день года, дату можно разрешить двумя способами. Вызов этого метода с аргументами YEAR и DAY_OF_YEAR обеспечит разрешение даты с использованием года и дня года; это означает, что месяц и день месяца будут игнорироваться на этапе разрешения.

Аналогичным образом этот метод можно использовать, чтобы игнорировать второстепенные поля, которые иначе подвергались бы перекрестной проверке. Например, если форматтер включает год, месяц, день месяца и день недели, дату можно разрешить только одним способом, но разобранное значение дня недели будет сверяться с разрешенной датой. Вызов этого метода с аргументами YEAR, MONTH_OF_YEAR и DAY_OF_MONTH обеспечит правильное разрешение даты без перекрестной проверки дня недели.

С точки зрения реализации этот метод работает следующим образом. Результат этапа разбора можно рассматривать как отображение полей в значения. Этот метод фильтрует такое отображение между первым и вторым этапами, удаляя все поля, кроме указанных в аргументах метода.

Этот экземпляр неизменяем, и вызов данного метода на него не влияет.

Форматирует дату и время в строку согласно правилам форматтера.

Записывает отформатированные дату и время в указанный объект назначения. Appendable — это универсальный интерфейс, реализуемый всеми основными классами для вывода символьных данных, включая StringBuffer, StringBuilder, PrintStream и Writer.

Хотя методы Appendable выбрасывают IOException, этот метод этого не делает. Вместо этого любой IOException оборачивается в исключение времени выполнения.

Разбирает весь текст и создает временной объект. Обычно удобнее использовать parse(CharSequence, TemporalQuery). Результатом этого метода является TemporalAccessor, которое прошло разрешение с применением базовых проверок, помогающих убедиться в корректности даты и времени.

Если разбор завершается, не считав весь текст, или во время разбора либо объединения возникает проблема, выбрасывается исключение.

Разбирает текст, не требуя начинать с начала строки или заканчивать в ее конце. Результатом этого метода является TemporalAccessor, которое прошло разрешение с применением базовых проверок, помогающих убедиться в корректности даты и времени.

Разбор текста начинается с указанной начальной ParsePosition. Разбирать весь текст целиком не требуется; ParsePosition будет обновлена и укажет индекс в конце разобранного фрагмента.

Этот метод работает несколько иначе, чем аналогичные методы, использующие ParsePosition в java.text.Format. Этот класс сообщает об ошибках с помощью индекса ошибки в ParsePosition. В отличие от него, этот метод при возникновении ошибки выбрасывает DateTimeParseException, содержащее индекс ошибки. Такое изменение поведения необходимо из-за большей сложности разбора и разрешения дат и времени в этом API.

Если форматтер разбирает одно и то же поле несколько раз с разными значениями, результатом будет ошибка.

В большинстве приложений для разбора следует использовать этот метод. Он разбирает весь текст и создает требуемую дату и время. Запрос обычно является ссылкой на метод from(TemporalAccessor). Например:

 LocalDateTime dt = parser.parse(str, LocalDateTime::from);

Этот метод разбора удобен, если парсер поддерживает необязательные элементы. Например, шаблон 'uuuu-MM-dd HH.mm[ VV]' может быть полностью разобран в ZonedDateTime или частично — в LocalDateTime. Запросы необходимо указывать в порядке убывания предпочтительности: сначала вариант наиболее полного разбора, затем вариант минимального разбора. Запрос обычно является ссылкой на метод from(TemporalAccessor).

Результат относится к первому типу, который удалось успешно разобрать. Обычно приложения используют instanceof для проверки результата. Например:

 TemporalAccessor dt = parser.parseBest(str, ZonedDateTime::from, LocalDateTime::from);
 if (dt instanceof ZonedDateTime) {
  ...
 } else {
  ...
 }

Разбор выполняется в два этапа. Сначала текст разбирается с использованием структуры, заданной форматтером, в результате чего создаются Map «поле — значение», ZoneId и Chronology. Затем разобранные данные разрешаются: различные поля проверяются, объединяются и упрощаются до более полезных. Этот метод выполняет этап разбора, но не этап разрешения.

Результатом этого метода является TemporalAccessor, представляющий данные в том виде, в каком они присутствуют во входных данных. Значения не проверяются, поэтому разбор строки даты '2012-00-65' приведёт к созданию временного объекта с тремя полями: годом '2012', месяцем '0' и днём месяца '65'.

Текст будет разобран начиная с указанной начальной позиции ParsePosition. Весь текст разбирать необязательно: ParsePosition будет обновлён индексом, указывающим конец разбора.

Ошибки возвращаются в поле индекса ошибки объекта ParsePosition, а не через DateTimeParseException. Возвращаемый индекс ошибки будет установлен в значение, указывающее на место ошибки. Перед использованием результата вызывающий код должен проверить наличие ошибок.

Если форматтер разбирает одно и то же поле несколько раз с разными значениями, результатом будет ошибка.

Этот метод предназначен для сложных случаев использования, в которых требуется доступ к внутреннему состоянию во время разбора. В обычном прикладном коде следует использовать parse(CharSequence, TemporalQuery) или метод разбора целевого типа.

Возвращаемый экземпляр Format форматирует любой TemporalAccessor и разбирает текст в разрешённый TemporalAccessor.

Исключения соответствуют определениям Format; подробные сведения о IllegalArgumentException при форматировании и о ParseException или null при разборе см. в описании этих методов. Формат не поддерживает назначение атрибутов возвращаемой строке форматирования.

Возвращаемый экземпляр Format форматирует любой TemporalAccessor и разбирает текст в указанный тип. Тип должен поддерживаться методом parse(CharSequence).

Исключения соответствуют определениям Format; подробные сведения о IllegalArgumentException при форматировании и о ParseException или null при разборе см. в описании этих методов. Формат не поддерживает назначение атрибутов возвращаемой строке форматирования.