Интерфейс 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()

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

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