Класс 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. Секунды в минуте выводятся всегда. Для наносекунд выводится ноль, три, шесть или девять цифр, в зависимости от необходимости. При анализе для разбора смещения используется поведение 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(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.

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

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

При разборе Instant обрабатывается особое время «високосной секунды» — «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.

Изменение стиля разрешения влияет только на разбор. Разбор текстовой строки выполняется в два этапа. На этапе 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) или метод parse целевого типа.

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

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

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

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