Класс TemporalQueries

java.lang.Object

java.time.temporal.TemporalQueries

public final class TemporalQueries extends Object

Общие реализации TemporalQuery.

Этот класс предоставляет общие реализации TemporalQuery. Они определены здесь, так как должны быть константами, а определение лямбда-выражений не гарантирует этого. Назначая их один раз здесь, они становятся обычными Java-константами.

Запросы — это ключевой инструмент для извлечения информации из временных объектов. Они предназначены для внешней реализации процесса запроса, позволяя использовать различные подходы, согласно паттерну проектирования «стратегия». Примеры могут включать запрос, проверяющий, является ли дата днём перед 29 февраля в високосном году, или вычисление количества дней до следующего дня рождения.

Интерфейс TemporalField предоставляет другой механизм для запроса временных объектов. Этот интерфейс ограничен возвращением long. В отличие от этого, запросы могут возвращать любой тип.

Есть два эквивалентных способа использования TemporalQuery. Первый — вызвать метод напрямую в этом интерфейсе. Второй — использовать TemporalAccessor.query(TemporalQuery):

   // these two lines are equivalent, but the second approach is recommended
   temporal = thisQuery.queryFrom(temporal);
   temporal = temporal.query(thisQuery);

Рекомендуется использовать второй подход, query(TemporalQuery), так как он гораздо понятнее в коде.

Наиболее распространённые реализации — ссылки на методы, такие как LocalDate::from и ZoneId::from. Дополнительные распространённые запросы предоставляют для возвращения:

календаря,
даты,
времени,
смещения часового пояса,
точности,
часового пояса, или
идентификатора часового пояса.

Since:: 1.8

Краткое описание методов

Модификатор и тип	Метод	Описание
`static TemporalQuery<Chronology>`	`chronology()`	Запрос для `Chronology`.
`static TemporalQuery<LocalDate>`	`localDate()`	Запрос для `LocalDate`, возвращающий null, если не найден.
`static TemporalQuery<LocalTime>`	`localTime()`	Запрос для `LocalTime`, возвращающий null, если не найден.
`static TemporalQuery<ZoneOffset>`	`offset()`	Запрос для `ZoneOffset`, возвращающий null, если не найден.
`static TemporalQuery<TemporalUnit>`	`precision()`	Запрос для наименьшего поддерживаемого подразделения.
`static TemporalQuery<ZoneId>`	`zone()`	Лёгкий запрос для `ZoneId`, используя `ZoneOffset` в качестве резервного варианта.
`static TemporalQuery<ZoneId>`	`zoneId()`	Строгий запрос для `ZoneId`.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание методов

zoneId

public static TemporalQuery<ZoneId> zoneId()

Строгий запрос для ZoneId.

Этот запрос выполняется к 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

Возвращает:: запрос, который может получить идентификатор зоны временной метки, не null

chronology

public static TemporalQuery<Chronology> chronology()

Запрос для Chronology.

Этот запрос выполняется к 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. Этот метод эквивалентен данному запросу, за исключением того, что он генерирует исключение, если хронология не может быть получена.

Возвращает:: запрос, который может получить хронологию временной метки, не null

precision

public static TemporalQuery<TemporalUnit> precision()

Запрос на наименьший поддерживаемый единицу измерения.

Этот запрос выполняется к 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

Возвращает:: запрос, который может получить точность временной метки, не null

zone

public static TemporalQuery<ZoneId> zone()

Умеренный запрос на ZoneId, использующий ZoneOffset в качестве резервного варианта.

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

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

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

Возвращает:: запрос, который может получить идентификатор зоны или смещение временной метки, не null

offset

public static TemporalQuery<ZoneOffset> offset()

Запрос на ZoneOffset, возвращающий null, если не найден.

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

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

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

Возвращает:: запрос, который может получить смещение временной метки, не null

localDate

public static TemporalQuery<LocalDate> localDate()

Запрос на LocalDate, возвращающий null, если не найден.

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

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

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

Возвращает:: запрос, который может получить дату временной метки, не null

localTime

public static TemporalQuery<LocalTime> localTime()

Запрос на LocalTime, возвращающий null, если не найден.

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

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

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

Возвращает:: запрос, который может получить время временной метки, не null

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/time/temporal/TemporalQueries.html