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

public static final ChronoUnit NANOS

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

public static final ChronoUnit MICROS

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

public static final ChronoUnit MILLIS

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

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 составит только один час, поскольку до двух часов не хватает одной минуты; промежуток в месяцах между датами 2024-09-29 и 2025-02-28 (последним днём февраля) составит 4 месяца, поскольку до пяти месяцев не хватает одного дня.

Этот метод можно использовать двумя эквивалентными способами. Первый — вызвать метод напрямую. Второй — использовать 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()

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