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

public static final ChronoUnit NANOS

Единица, представляющая понятие наносекунды, наименьшей поддерживаемой единицы времени. Для системы ISO календаря она равна 1/1000000000 секунды.

public static final ChronoUnit MICROS

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

public static final ChronoUnit MILLIS

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

public static final ChronoUnit SECONDS

Единица, представляющая понятие секунды. Для системы ISO календаря она равна секунде в СИ системе единиц, за исключением високосных секунд.

public static final ChronoUnit MINUTES

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

public static final ChronoUnit HOURS

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

public static final ChronoUnit HALF_DAYS

Единица, представляющая понятие половины дня, как используется в AM/PM. Для системы ISO календаря она равна 12 часам.

public static final ChronoUnit DAYS

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

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

public static final ChronoUnit WEEKS

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

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

public static final ChronoUnit MONTHS

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

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

public static final ChronoUnit YEARS

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

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

public static final ChronoUnit DECADES

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

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

public static final ChronoUnit CENTURIES

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

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

public static final ChronoUnit MILLENNIA

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

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

public static final ChronoUnit ERAS

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

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

public static final ChronoUnit FOREVER

Искусственная единица, представляющая понятие вечности. Она в основном используется с TemporalField для представления неограниченных полей, таких как год или эра. Приблизительная продолжительность этой единицы искусственно определена как наибольшая продолжительность, поддерживаемая Duration.

public static ChronoUnit[] values()

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

public static ChronoUnit valueOf(String name)

Возвращает константу перечисления этого класса с указанным именем. Строка должна точно соответствовать идентификатору, используемому для объявления константы перечисления в этом классе. (Дополнительные пробелы недопустимы.)

public Duration getDuration()

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

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

public boolean isDurationEstimated()

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

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

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

public boolean isDateBased()

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

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

public boolean isTimeBased()

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

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

public <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.

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

public 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. Реализации не должны изменять указанные временные объекты.

public String toString()

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