Класс 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.