Класс 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 формат, указывающий часовой пояс. Формат состоит из:

• 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. Секунды всегда выводятся. Миллисекунды выводятся нулём, тремя, шестью или девятью знаками по мере необходимости. При анализе используется поведение 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 обычно требуют временной зоны. При форматировании с использованием этих стилей должна быть доступна 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).

     "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());
 

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

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

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

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

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

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

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

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

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

Возвращает переопределённую хронологию, используемую для преобразования дат. По умолчанию форматировщик не имеет переопределяющей хронологии, возвращая 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 вместо parse(CharSequence, TemporalQuery). Возвращаемый индекс ошибки будет установлен на индекс, указывающий на ошибку. Вызывающие стороны должны проверять наличие ошибок перед использованием результата.

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

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

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

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

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

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