Класс 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,
  • точности,
  • часового пояса, или
  • идентификатора часового пояса.
С момента:
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.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/temporal/TemporalQueries.html

Spec-Zone .ru
спецификации, руководства, описания, API