Интерфейс TemporalUnit

Duration getDuration()

Получает длительность данного элемента, которая может быть оценочной.

Все элементы возвращают длительность, измеряемую в стандартных наносекундах с помощью этого метода. Длительность будет положительной и отличной от нуля. Например, час имеет длительность 60 * 60 * 1,000,000,000ns.

Некоторые элементы могут возвращать точную длительность, в то время как другие возвращают оценку. Например, дни имеют оценочную длительность из-за возможности изменения летнего времени. Чтобы определить, является ли длительность оценочной, используйте isDurationEstimated().

boolean isDurationEstimated()

Проверяет, является ли длительность элемента оценочной.

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

boolean isDateBased()

Проверяет, представляет ли данный элемент компонент даты.

Дата является временной, если её можно использовать для определения значения по дате. Она должна иметь длительность, являющуюся целым кратным длительности стандартного дня. Обратите внимание, что для isDateBased() и isTimeBased() допустимо возвращать false, например, при представлении такого элемента, как 36 часов.

boolean isTimeBased()

Проверяет, представляет ли данный элемент компонент времени.

Элемент является временным, если его можно использовать для определения значения по времени. Он должен иметь длительность, кратную длительности стандартного дня без остатка. Обратите внимание, что для isDateBased() и isTimeBased() допустимо возвращать false, например, при представлении такого элемента, как 36 часов.

default boolean isSupportedBy(Temporal temporal)

Проверяет, поддерживается ли данный элемент указанным временным объектом.

Проверка, что реализуемая дата-время может добавить/вычесть этот элемент. Это можно использовать, чтобы избежать исключения.

Эта реализация по умолчанию получает значение с помощью Temporal.plus(long, TemporalUnit).

<R extends Temporal> R addTo(R temporal, long amount)

Возвращает копию указанного временного объекта с добавленным заданным периодом.

Добавляемый период является кратным этому элементу. Например, этот метод можно использовать для добавления «3 дней» к дате, вызвав этот метод для элемента, представляющего «дни», передав дату и период «3». Добавляемый период может быть отрицательным, что эквивалентно вычитанию.

Есть два эквивалентных способа использования этого метода. Первый — вызвать этот метод напрямую. Второй — использовать Temporal.plus(long, TemporalUnit):

   // these two lines are equivalent, but the second approach is recommended
   temporal = thisUnit.addTo(temporal);
   temporal = temporal.plus(thisUnit);
 

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

Реализации должны выполнять любые запросы или вычисления, используя элементы, доступные в ChronoUnit, или поля, доступные в ChronoField. Если элемент не поддерживается, должно быть выброшено UnsupportedTemporalTypeException.

Реализации не должны изменять указанный временной объект. Вместо этого должен возвращаться скорректированный дубликат оригинала. Это обеспечивает эквивалентное безопасное поведение для неизменяемых и изменяемых реализаций.

long between(Temporal temporal1Inclusive, Temporal temporal2Exclusive)

Вычисляет временной промежуток между двумя временными объектами.

Вычисляет количество в терминах этого элемента. Начальная и конечная точки предоставляются как временные объекты и должны быть совместимого типа. Реализация преобразует вторую точку в экземпляр первого типа перед вычислением количества. Результат будет отрицательным, если конечная точка находится до начальной. Например, количество часов между двумя временными объектами можно вычислить, используя HOURS.between(startTime, endTime).

Вычисление возвращает целое число, представляющее количество полных элементов между двумя временными точками. Например, количество часов между временами 11:30 и 13:29 будет только один час, так как это на одну минуту меньше двух часов.

Есть два эквивалентных способа использования этого метода. Первый — вызвать этот метод напрямую. Второй — использовать Temporal.until(Temporal, TemporalUnit):

   // these two lines are equivalent
   between = thisUnit.between(start, end);
   between = start.until(end, thisUnit);
 

Выбор должен быть сделан на основе того, что делает код более читабельным.

Например, этот метод позволяет вычислить количество дней между двумя датами:

  long daysBetween = DAYS.between(start, end);
  // or alternatively
  long daysBetween = start.until(end, DAYS);
 

Реализации должны выполнять любые запросы или вычисления, используя элементы, доступные в ChronoUnit, или поля, доступные в ChronoField. Если элемент не поддерживается, должно быть выброшено UnsupportedTemporalTypeException. Реализации не должны изменять указанные временные объекты.

String toString()

Получает описательное имя элемента.

Оно должно быть во множественном числе и с заглавной буквой, например, 'Дни' или 'Минуты'.