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

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

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