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