Перечисление ChronoUnit

Единица, представляющая понятие дня. Для календарной системы ISO это стандартный день с полуночи до полуночи. Приблизительная продолжительность дня составляет 24 Hours.

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

Единица, представляющая понятие недели. Для календарной системы ISO она равна 7 дням.

При использовании с другими календарными системами она должна соответствовать целому числу дней.

Единица, представляющая понятие месяца. Для календарной системы ISO длина месяца варьируется в зависимости от месяца года. Приблизительная продолжительность месяца составляет одну двенадцатую от 365.2425 Days.

При использовании с другими календарными системами она должна соответствовать целому числу дней.

Единица, представляющая понятие года. Для календарной системы ISO она равна 12 месяцам. Приблизительная продолжительность года составляет 365.2425 Days.

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

Единица, представляющая понятие десятилетия. Для календарной системы ISO оно равно 10 годам.

При использовании с другими календарными системами она должна соответствовать целому числу дней и обычно целому числу лет.

Единица, представляющая понятие века. Для календарной системы ISO оно равно 100 годам.

При использовании с другими календарными системами она должна соответствовать целому числу дней и обычно целому числу лет.

Единица, представляющая понятие тысячелетия. Для календарной системы ISO оно равно 1000 годам.

При использовании с другими календарными системами она должна соответствовать целому числу дней и обычно целому числу лет.

Единица, представляющая понятие эры. Календарная система ISO не имеет эр, поэтому добавление эры к дате или дате-времени невозможно. Приблизительная продолжительность эры искусственно определена как 1,000,000,000 Years.

При использовании с другими календарными системами нет ограничений на единицу.

Возвращает приблизительную продолжительность этой единицы в календарной системе ISO.

Все единицы в этом классе имеют приблизительную продолжительность. Дни меняются из-за летнего времени, а месяцы имеют разную длину.

Проверяет, является ли продолжительность единицы приблизительной.

Все единицы времени в этом классе считаются точными, а все единицы дат в этом классе — приблизительными.

Это определение игнорирует високосные секунды, но учитывает, что продолжительность дней меняется из-за перехода на летнее время, а месяцы имеют различную длину.

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

Все единицы от дней до эр включительно являются единицами даты. Единицы времени и FOREVER возвращают false.

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

Все единицы от наносекунд до полусуток включительно являются единицами времени. Единицы даты и FOREVER возвращают false.

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

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

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

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

Добавляемый период — это кратное этой единицы. Например, этот метод можно использовать для добавления "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);

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

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

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

Это вычисляет величину в данном формате. Начальная и конечная точки предоставляются как временные объекты и должны быть совместимых типов. Реализация преобразует второй тип в экземпляр первого типа перед вычислением величины. Результат будет отрицательным, если конечная точка предшествует начальной. Например, величину в часах между двумя временными объектами можно вычислить, используя 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. Реализации не должны изменять указанные временные объекты.