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

Все реализуемые интерфейсы:
Serializable, Comparable<ChronoUnit>, TemporalUnit 
public enum ChronoUnit
extends Enum<ChronoUnit>
implements TemporalUnit

Стандартный набор единиц периодов дат.

Этот набор единиц предоставляет доступ к манипулированию датой, временем или датой и временем на основе единиц. Стандартный набор единиц можно расширить, реализовав TemporalUnit.

Эти единицы предназначены для использования в нескольких календарных системах. Например, большинство календарных систем, не являющихся ISO, определяют единицы лет, месяцев и дней, просто с немного другими правилами. Документация каждой единицы объясняет, как она работает.

Требования к реализации:
Это окончательное, неизменяемое и потокобезопасное перечисление.
С:
1.8

Постоянные значения перечисления

Постоянное значение перечисления Описание
CENTURIES

Единица, представляющая понятие столетия.
DAYS

Единица, представляющая понятие дня.
DECADES

Единица, представляющая понятие десятилетия.
ERAS

Единица, представляющая понятие эры.
FOREVER

Искусственная единица, представляющая понятие вечности.
HALF_DAYS

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

Единица, представляющая понятие часа.
MICROS

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

Единица, представляющая понятие тысячелетия.
MILLIS

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

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

Единица, представляющая понятие месяца.
NANOS

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

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

Единица, представляющая понятие недели.
YEARS

Единица, представляющая понятие года.

Методы

Модификатор и тип Метод Описание
Duration getDuration()

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

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

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

Проверяет, является ли эта единица единицей времени.
static ChronoUnit valueOf​(String name)

Возвращает константу перечисления этого типа с заданным именем.
static ChronoUnit[] values()

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

Методы, объявленные в классе java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Методы, объявленные в классе java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе java.time.temporal.TemporalUnit

addTo, between, isSupportedBy, toString

Постоянные значения перечисления

НАНОСЕКУНДЫ

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.

Методы

values

public static ChronoUnit[] values()

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

for (ChronoUnit c : ChronoUnit.values())
    System.out.println(c);

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

valueOf

public static ChronoUnit valueOf(String name)

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

Параметры:
name - имя возвращаемой константы перечисления.
Возвращает:
константа перечисления с заданным именем
Исключения:
IllegalArgumentException - если в этом типе перечисления нет константы с заданным именем
NullPointerException - если аргумент равен null

getDuration

public Duration getDuration()

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

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

Определено в:
getDuration в интерфейсе TemporalUnit
Возвращает:
приблизительная продолжительность этой единицы, не null

isDurationEstimated

public boolean isDurationEstimated()

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

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

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

Определено в:
isDurationEstimated в интерфейсе TemporalUnit
Возвращает:
true, если продолжительность приблизительная, false, если точная

isDateBased

public boolean isDateBased()

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

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

Определено в:
isDateBased в интерфейсе TemporalUnit
Возвращает:
true, если единица даты, false, если единица времени

isTimeBased

public boolean isTimeBased()

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

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

Определено в:
isTimeBased в интерфейсе TemporalUnit
Возвращает:
true, если единица времени, false, если единица даты

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/temporal/ChronoUnit.html

Spec-Zone .ru
спецификации, руководства, описания, API