Класс 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(java.lang.CharSequence, java.time.temporal.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(java.lang.CharSequence, java.time.temporal.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(java.lang.CharSequence, java.time.temporal.TemporalQuery<?>...).

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

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

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

Поскольку у этого форматировщика есть необязательный элемент, может потребоваться анализ с помощью parseBest(java.lang.CharSequence, java.time.temporal.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(java.lang.CharSequence, java.time.temporal.TemporalQuery<?>...).

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

Возвращает неизменяемый форматировщик, способный форматировать и анализировать формат момента ISO-8601. При форматировании момент всегда будет суффиксен 'Z', чтобы указать UTC. Вторая минуты всегда выводится. Наносекунды выводится 0, 3, 6 или 9 цифр по мере необходимости. При анализе используется поведение DateTimeFormatterBuilder.appendOffsetId() для анализа смещения, переводя момент в 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(java.lang.CharSequence, java.time.temporal.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 обычно требуют часового пояса. При форматировании с использованием этих стилей должен быть доступен часовой пояс, либо используя ZonedDateTime, либо withZone(java.time.ZoneId).

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

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

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

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

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

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

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

Возвращаемый форматер имеет хронологию ISO, чтобы гарантировать правильное преобразование дат в других календарных системах. Он не имеет переопределённой зоны и использует стиль разрешения SMART. Стиль FULL и LONG обычно требуют часового пояса. При форматировании с использованием этих стилей должен быть доступен часовой пояс, либо используя ZonedDateTime, либо withZone(java.time.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.

Возвращает единственный экземпляр запроса, предоставляющего доступ к дополнительной информации из разбора. Запрос всегда возвращает непустой период, возвращая нулевой период вместо 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());
 

Возвращает единственный экземпляр запроса, предоставляющего доступ к дополнительной информации из разбора. Запрос всегда возвращает логическое значение, 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().

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

Используется для поиска любой части форматировщика, требующей конкретной локализации, например, текста или локализованного шаблона. Если локаль содержит расширения "ca" (календарь), "nu" (система нумерации), "rg" (переопределение региона) и/или "tz" (часовой пояс) Unicode расширений, хронология, система нумерации и/или пояс переопределяются. Если указаны оба "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.

Изменение стиля разрешения влияет только при анализе. Анализ строки текста происходит в две фазы. Фаза 1 — это базовый анализ текста в соответствии с полями, добавленными в конструктор. Фаза 2 разрешает пары поле-значение, проанализированные в объекты даты и/или времени. Стиль разрешения используется для управления тем, как происходит фаза 2, разрешения. Смотрите ResolverStyle для получения дополнительной информации о доступных вариантах.

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

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

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

Изменение полей разрешения влияет только при анализе. Анализ строки текста происходит в две фазы. Фаза 1 — это базовый анализ текста в соответствии с полями, добавленными в конструктор. Фаза 2 разрешает пары поле-значение, проанализированные в объекты даты и/или времени. Поля разрешения используются для фильтрации пар поле-значение между фазой 1 и 2.

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

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

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

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

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

Изменение полей разрешения влияет только при анализе. Анализ строки текста происходит в две фазы. Фаза 1 — это базовый анализ текста в соответствии с полями, добавленными в конструктор. Фаза 2 разрешает пары поле-значение, проанализированные в объекты даты и/или времени. Поля разрешения используются для фильтрации пар поле-значение между фазой 1 и 2.

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

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

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

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

Это форматирует дату-время в строку, используя правила форматера.

Это выводит отформатированную дату-время в указанное место назначения. 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(java.lang.CharSequence).

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