Класс TemporalQueries

Этот запрос получает часовой пояс для TemporalAccessor. Часовой пояс возвращается только если объект времени концептуально содержит ZoneId. Он не будет возвращен, если объект времени концептуально содержит только ZoneOffset. Таким образом, ZonedDateTime вернет результат getZone(), а OffsetDateTime вернет null.

В большинстве случаев приложения должны использовать zone(), так как этот запрос слишком строгий.

Результат работы классов JDK, реализующих TemporalAccessor, следующий:
LocalDate возвращает null
LocalTime возвращает null
LocalDateTime возвращает null
ZonedDateTime возвращает связанный часовой пояс
OffsetTime возвращает null
OffsetDateTime возвращает null
ChronoLocalDate возвращает null
ChronoLocalDateTime возвращает null
ChronoZonedDateTime возвращает связанный часовой пояс
Era возвращает null
DayOfWeek возвращает null
Month возвращает null
Year возвращает null
YearMonth возвращает null
MonthDay возвращает null
ZoneOffset возвращает null
Instant возвращает null

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

Результат работы классов JDK, реализующих TemporalAccessor, следующий:
LocalDate возвращает IsoChronology.INSTANCE
LocalTime возвращает null (не представляет дату)
LocalDateTime возвращает IsoChronology.INSTANCE
ZonedDateTime возвращает IsoChronology.INSTANCE
OffsetTime возвращает null (не представляет дату)
OffsetDateTime возвращает IsoChronology.INSTANCE
ChronoLocalDate возвращает связанную хронологию
ChronoLocalDateTime возвращает связанную хронологию
ChronoZonedDateTime возвращает связанную хронологию
Era возвращает связанную хронологию
DayOfWeek возвращает null (общий для всех хронологий)
Month возвращает IsoChronology.INSTANCE
Year возвращает IsoChronology.INSTANCE
YearMonth возвращает IsoChronology.INSTANCE
MonthDay возвращает null IsoChronology.INSTANCE
ZoneOffset возвращает null (не представляет дату)
Instant возвращает null (не представляет дату)

Метод Chronology.from(TemporalAccessor) может использоваться как TemporalQuery через ссылку на метод, Chronology::from. Этот метод эквивалентен этому запросу, за исключением того, что он генерирует исключение, если хронология не может быть получена.

Этот запрос получает точность времени для TemporalAccessor. Если целевой TemporalAccessor представляет согласованную или полную дату-время, дату или время, то он должен вернуть минимальную поддерживаемую точность. Обратите внимание, что поля, такие как NANO_OF_DAY и NANO_OF_SECOND определены как всегда игнорирующие точность, поэтому это единственный способ узнать фактическую минимальную поддерживаемую единицу. Например, если бы GregorianCalendar реализовывал TemporalAccessor, он бы вернул точность MILLIS.

Результат работы классов JDK, реализующих TemporalAccessor, следующий:
LocalDate возвращает DAYS
LocalTime возвращает NANOS
LocalDateTime возвращает NANOS
ZonedDateTime возвращает NANOS
OffsetTime возвращает NANOS
OffsetDateTime возвращает NANOS
ChronoLocalDate возвращает DAYS
ChronoLocalDateTime возвращает NANOS
ChronoZonedDateTime возвращает NANOS
Era возвращает ERAS
DayOfWeek возвращает DAYS
Month возвращает MONTHS
Year возвращает YEARS
YearMonth возвращает MONTHS
MonthDay возвращает null (не представляет полную дату или время)
ZoneOffset возвращает null (не представляет дату или время)
Instant возвращает NANOS

Этот запрос получает часовой пояс для TemporalAccessor. Сначала он пытается получить часовой пояс, используя zoneId(). Если он не найден, он пытается получить offset(). Таким образом, ZonedDateTime вернет результат getZone(), а OffsetDateTime вернет результат getOffset().

В большинстве случаев приложения должны использовать этот запрос, а не #zoneId().

Метод ZoneId.from(TemporalAccessor) может использоваться как TemporalQuery через ссылку на метод, ZoneId::from. Этот метод эквивалентен этому запросу, за исключением того, что он генерирует исключение, если часовой пояс не может быть получен.

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

Реализация запроса проверяет поле OFFSET_SECONDS и использует его для создания ZoneOffset.

Метод ZoneOffset.from(TemporalAccessor) может использоваться как TemporalQuery через ссылку на метод, ZoneOffset::from. Этот запрос и ZoneOffset::from вернут один и тот же результат, если временной объект содержит смещение. Если временной объект не содержит смещения, ссылка на метод сгенерирует исключение, а этот запрос вернет null.

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

Реализация запроса проверяет поле EPOCH_DAY и использует его для создания LocalDate.

Метод LocalDate.from(TemporalAccessor) может использоваться как TemporalQuery через ссылку на метод, LocalDate::from. Этот запрос и LocalDate::from вернут один и тот же результат, если временной объект содержит дату. Если временной объект не содержит даты, ссылка на метод сгенерирует исключение, а этот запрос вернет null.

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

Реализация запроса проверяет поле NANO_OF_DAY и использует его для создания LocalTime.

Метод LocalTime.from(TemporalAccessor) может использоваться как TemporalQuery через ссылку на метод, LocalTime::from. Этот запрос и LocalTime::from вернут один и тот же результат, если временной объект содержит время. Если временной объект не содержит времени, ссылка на метод сгенерирует исключение, а этот запрос вернет null.