Класс DateTimeFormatter

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

• Четыре или более цифр для year. Года в диапазоне от 0000 до 9999 будут дополнены нулями до четырёх цифр. Годы за пределами этого диапазона будут иметь префиксный положительный или отрицательный знак.
• Дефис
• Две цифры для month-of-year. Они дополняются нулём до двух цифр.
• Дефис
• Две цифры для 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 формат, указывающий часовой пояс. Формат состоит из:

• Формата 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.
• Если идентификатор часового пояса недоступен или является ZoneOffset, формат завершён.
• Открывающая квадратная скобка '['.
• Идентификатора часового пояса zone ID. Это не часть стандарта ISO-8601. Анализ чувствителен к регистру.
• Закрывающая квадратная скобка ']'.

Так как этот форматировщик имеет необязательный элемент, может потребоваться анализ с помощью parseBest(java.lang.CharSequence, java.time.temporal.TemporalQuery<?>...).

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

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

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

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

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

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

• Четыре и более цифр для week-based-year. Годы в диапазоне от 0000 до 9999 будут дополнены нулями слева, чтобы гарантировать четыре цифры. Годы за пределами этого диапазона будут иметь префиксный знак плюс или минус.
• Дефис
• Буква 'W'. Анализ регистронезависимый.
• Две цифры для week-of-week-based-year. Дополняется нулями слева, чтобы гарантировать две цифры.
• Дефис
• Одна цифра для 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 при необходимости. Время до поля секунд обязательно. Дробные секунды от 0 до 9 анализируются. Локализованный десятичный стиль не используется.

Это особый форматировщик, предназначенный для отображения удобочитаемой формы 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 обычно требуют часовой пояс. При форматировании с использованием этих стилей должен быть доступен ZoneId часовой пояс, либо с использованием ZonedDateTime либо withZone(java.time.ZoneId).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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