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

public static final ChronoUnit NANOS

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

public static final ChronoUnit MICROS

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

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()

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