Класс 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. Дополнительные распространённые запросы предоставляются для возврата:

календаря,
LocalDate,
LocalTime,
ZoneOffset,
точности,
зоны, или
zoneId.

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.

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

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

localTime

public static TemporalQuery<LocalTime> localTime()

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

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

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

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

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

© 1993, 2020, 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.