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

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

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