ChronoUnit (Платформа Java SE 8 b92)

java.lang. Объект
- java.lang. Перечисление <ChronoUnit>
- - java.time.temporal. ChronoUnit

Все Реализованные Интерфейсы:

Сериализуемый, Сопоставимый <ChronoUnit>, TemporalUnit
```
public enum ChronoUnit
extends Enum<ChronoUnit>
implements TemporalUnit
```
Стандартный набор модулей периодов даты.
Этот набор модулей обеспечивает основанный на модуле доступ, чтобы управлять датой, время или разовый датой. Стандартный набор модулей может быть расширен, реализовывая TemporalUnit.
Эти модули предназначаются, чтобы быть применимыми в многократных календарных системах. Например, большинство календарных систем не-ISO определяет модули лет, месяцев и дней, только с немного отличающимися правилами. Документация каждого модуля объясняет, как это работает.

Требования реализации:

Это - заключительное, неизменное и ориентированное на многопотоковое исполнение перечисление.

С тех пор:

1.8

Перечислимая Постоянная Сводка

Перечислимые Константы
Перечислимая Константа и Описание
`СТОЛЕТИЯ` Модуль, который представляет понятие столетия.
`ДНИ` Модуль, который представляет понятие дня.
`ДЕСЯТИЛЕТИЯ` Модуль, который представляет понятие десятилетия.
`ERA` Модуль, который представляет понятие эры.
`НАВСЕГДА` Искусственный модуль, который представляет понятие навсегда.
`HALF_DAYS` Модуль, который представляет понятие половины дня, как использующийся в,/PM.
`ЧАСЫ` Модуль, который представляет понятие часа.
`MICROS` Модуль, который представляет понятие микросекунды.
`ТЫСЯЧЕЛЕТИЯ` Модуль, который представляет понятие тысячелетия.
`MILLIS` Модуль, который представляет понятие миллисекунды.
`МИНУТЫ` Модуль, который представляет понятие минуты.
`МЕСЯЦЫ` Модуль, который представляет понятие месяца.
`NANOS` Модуль, который представляет понятие наносекунды, самой маленькой поддерживаемой единицы времени.
`СЕКУНДЫ` Модуль, который представляет понятие секунды.
`НЕДЕЛИ` Модуль, который представляет понятие недели.
`ГОДЫ` Модуль, который представляет понятие года.

Сводка метода

Все Методы Статические Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`<R extends Temporal> R`	`addTo(R temporal, long amount)` Возвращает копию указанного временного объекта с добавленным установленным периодом.
`long`	`between(Temporal temporal1, Temporal temporal2)` Вычисляет количество времени между двумя временными объектами.
`Продолжительность`	`getDuration()` Получает предполагаемую продолжительность этого модуля в календарной системе ISO.
`Строка`	`getName()` Получает описательное имя для модуля.
`boolean`	`isDateUnit()` Проверки, если этот модуль является модулем даты.
`boolean`	`isDurationEstimated()` Проверки, если продолжительность модуля является оценкой.
`boolean`	`isSupportedBy(Temporal temporal)` Проверки, если этот модуль поддерживается указанным временным объектом.
`boolean`	`isTimeUnit()` Проверки, если этот модуль является единицей измерения времени.
`Строка`	`toString()` Возвращает имя этой перечислимой константы, как содержащийся в объявлении.
`static ChronoUnit`	`valueOf(String name)` Возвращает перечислимую константу этого типа с указанным именем.
`static ChronoUnit[]`	`values()` Возвращает массив, содержащий константы этого перечислимого типа, в порядке, которым они объявляются.

Методы, наследованные от class java.lang. Перечисление
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Методы, наследованные от class java.lang. Объект
getClass, notify, notifyAll, wait, wait, wait

- Перечислимая Постоянная Деталь
  - NANOS
```
public static final ChronoUnit NANOS
```
    Модуль, который представляет понятие наносекунды, самой маленькой поддерживаемой единицы времени. Для календарной системы ISO это равно 1,000,000,000-ой части второго модуля.
  - MICROS
```
public static final ChronoUnit MICROS
```
    Модуль, который представляет понятие микросекунды. Для календарной системы ISO это равно 1,000,000-ой части второго модуля.
  - MILLIS
```
public static final ChronoUnit MILLIS
```
    Модуль, который представляет понятие миллисекунды. Для календарной системы ISO это равно 1000-ой части второго модуля.
  - СЕКУНДЫ
```
public static final ChronoUnit SECONDS
```
    Модуль, который представляет понятие секунды. Для календарной системы ISO это равно второму в системе SI модулей, кроме приблизительно с секундой прыжка.
  - МИНУТЫ
```
public static final ChronoUnit MINUTES
```
    Модуль, который представляет понятие минуты. Для календарной системы ISO это равно 60 секундам.
  - ЧАСЫ
```
public static final ChronoUnit HOURS
```
    Модуль, который представляет понятие часа. Для календарной системы ISO это равно 60 минутам.
  - HALF_DAYS
```
public static final ChronoUnit HALF_DAYS
```
    Модуль, который представляет понятие половины дня, как использующийся в,/PM. Для календарной системы ISO это равно 12 часам.
  - ДНИ
```
public static final ChronoUnit DAYS
```
    Модуль, который представляет понятие дня. Для календарной системы ISO это - стандартный день с полуночи до полуночи. Предполагаемая продолжительность дня 24 Hours.
    Когда использующийся с другими календарными системами это должно соответствовать дню, определенному повышением и установкой Sun на Земле. Не требуется, что дни начинаются в полночь - преобразовывая между календарными системами, дата должна быть эквивалентной в полдень.
  - НЕДЕЛИ
```
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.
    Когда использующийся с другими календарными системами это должно соответствовать целому числу дней или месяцев, примерно равных году, определенному проходом Земли вокруг Sun.
  - ДЕСЯТИЛЕТИЯ
```
public static final ChronoUnit DECADES
```
    Модуль, который представляет понятие десятилетия. Для календарной системы ISO это равно 10 годам.
    Когда использующийся с другими календарными системами это должно соответствовать целому числу дней и обычно является целым числом лет.
  - СТОЛЕТИЯ
```
public static final ChronoUnit CENTURIES
```
    Модуль, который представляет понятие столетия. Для календарной системы ISO это равно 100 годам.
    Когда использующийся с другими календарными системами это должно соответствовать целому числу дней и обычно является целым числом лет.
  - ТЫСЯЧЕЛЕТИЯ
```
public static final ChronoUnit MILLENNIA
```
    Модуль, который представляет понятие тысячелетия. Для календарной системы ISO это равно 1000 лет.
    Когда использующийся с другими календарными системами это должно соответствовать целому числу дней и обычно является целым числом лет.
  - ERA
```
public static final ChronoUnit ERAS
```
    Модуль, который представляет понятие эры. У календарной системы ISO нет эр таким образом, невозможно добавить эру к дате или разовый датой. Предполагаемая продолжительность эры искусственно определяется как 1,000,000,000 Years.
    Когда использующийся с другими календарными системами нет никаких ограничений на модуль.
  - НАВСЕГДА
```
public static final ChronoUnit FOREVER
```
    Искусственный модуль, который представляет понятие навсегда. Это прежде всего используется с TemporalField представлять неограниченные поля, такие как год или эра. Предполагаемая продолжительность эры искусственно определяется как самая большая продолжительность, поддерживаемая Duration.
- Деталь метода
  - значения
```
public static ChronoUnit[] values()
```
    Возвращает массив, содержащий константы этого перечислимого типа, в порядке, которым они объявляются. Этот метод может использоваться, чтобы выполнить итерации по константам следующим образом:
```
for (ChronoUnit c : ChronoUnit.values())
 System.out.println(c);
```
    Возвраты:
    
    массив, содержащий константы этого перечислимого типа, в порядке, они объявляются
  - valueOf
```
public static ChronoUnit valueOf(String name)
```
    Возвращает перечислимую константу этого типа с указанным именем. Строка должна соответствовать точно идентификатор, используемый, чтобы объявить перечислимую константу в этом типе. (Посторонние пробельные символы не разрешаются.)
    
    Параметры:
    
    name - имя перечислимой константы, которая будет возвращена.
    
    Возвраты:
    
    перечислимая константа с указанным именем
    
    Броски:
    
    IllegalArgumentException - если у этого перечислимого типа нет никакой константы с указанным именем
    
    NullPointerException - если параметром является нуль
  - getName
```
public String getName()
```
    Описание скопировало с интерфейса: TemporalUnit
    
    Получает описательное имя для модуля.
    Это должно быть во множественном числе и верхнем первом Camel-регистре, таком как 'Дни' или 'Минуты'.
    
    Определенный:
    
    getName в интерфейсе TemporalUnit
    
    Возвраты:
    
    имя, не нуль
  - getDuration
```
public Duration getDuration()
```
    Получает предполагаемую продолжительность этого модуля в календарной системе ISO.
    У всех модулей в этом class есть предполагаемая продолжительность. Дни изменяются из-за летнего времени, в то время как у месяцев есть различные длины.
    
    Определенный:
    
    getDuration в интерфейсе TemporalUnit
    
    Возвраты:
    
    предполагаемая продолжительность этого модуля, не нуль
  - isDurationEstimated
```
public boolean isDurationEstimated()
```
    Проверки, если продолжительность модуля является оценкой.
    Все единицы измерения времени в этом class, как полагают, точны, в то время как все модули даты в этом class, как полагают, оцениваются.
    Это определение игнорирует секунды прыжка, но полагает, что Дни изменяются из-за летнего времени, и у месяцев есть различные длины.
    
    Определенный:
    
    isDurationEstimated в интерфейсе TemporalUnit
    
    Возвраты:
    
    истина, если продолжительность оценивается, ложь если точный
  - isDateUnit
```
public boolean isDateUnit()
```
    Проверки, если этот модуль является модулем даты.
    
    Возвраты:
    
    истина, если модуль даты, ложь, если единица измерения времени
  - isTimeUnit
```
public boolean isTimeUnit()
```
    Проверки, если этот модуль является единицей измерения времени.
    
    Возвраты:
    
    истина, если единица измерения времени, ложь, если модуль даты
  - isSupportedBy
```
public boolean isSupportedBy(Temporal temporal)
```
    Описание скопировало с интерфейса: TemporalUnit
    
    Проверки, если этот модуль поддерживается указанным временным объектом.
    Это проверяет, что разовая датой реализация может добавить/вычесть этот модуль. Это может использоваться, чтобы избежать выдавать исключение.
    Эта реализация по умолчанию получает использование значения Temporal.plus(long, TemporalUnit).
    
    Определенный:
    
    isSupportedBy в интерфейсе TemporalUnit
    
    Параметры:
    
    temporal - временный объект проверить, не нуль
    
    Возвраты:
    
    истина, если модуль поддерживается
  - addTo
```
public <R extends Temporal> R addTo(R temporal,
                                    long amount)
```
    Описание скопировало с интерфейса: 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);
 
```
    Рекомендуется использовать второй подход, plus(TemporalUnit), поскольку это является намного более четким, чтобы читать в коде.
    Реализации должны выполнить любые запросы или вычисления, используя модули, доступные в ChronoUnit или поля, доступные в ChronoField. Если модуль не поддерживается UnsupportedTemporalTypeException должен быть брошен.
    Реализации не должны изменить указанный временный объект. Вместо этого должна быть возвращена скорректированная копия оригинала. Это обеспечивает эквивалентное, безопасное поведение для неизменных и изменчивых реализаций.
    Определенный:
    
    addTo в интерфейсе TemporalUnit
    
    Введите Параметры:
    
    R - тип Временного объекта
    
    Параметры:
    
    temporal - временный объект скорректировать, не нуль
    
    amount - количество этого модуля, чтобы добавить, положительный или отрицательный
    
    Возвраты:
    
    скорректированный временный объект, не нуль
  - между
```
public long between(Temporal temporal1,
                    Temporal temporal2)
```
    Описание скопировало с интерфейса: TemporalUnit
    Вычисляет количество времени между двумя временными объектами.
    Это вычисляет количество с точки зрения этого модуля. Запуск и конечные точки предоставляются как временные объекты и должны иметь тот же самый тип. Результат будет отрицателен, если конец будет перед запуском. Например, количество в часах между двумя временными объектами может быть вычислено, используя HOURS.between(startTime, endTime).
    Вычисление возвращает целое число, представляя число полных модулей между двумя temporals. Например, количество в часах между временами 11:30 и 13:29 только будет одним часом, поскольку это - одна минута за исключением двух часов.
    Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод непосредственно. Второе должно использовать Temporal.periodUntil(Temporal, TemporalUnit):
```
   // these two lines are equivalent
   between = thisUnit.between(start, end);
   between = start.periodUntil(end, thisUnit);
 
```
    Выбор должен быть сделан основанный, которого делает код более читаемым.
    Например, этот метод позволяет числу дней между двумя датами быть вычисленным:
```
  long daysBetween = DAYS.between(start, end);
  // or alternatively
  long daysBetween = start.periodUntil(end, DAYS);
 
```
    Реализации должны выполнить любые запросы или вычисления, используя модули, доступные в ChronoUnit или поля, доступные в ChronoField. Если модуль не поддерживается UnsupportedTemporalTypeException должен быть брошен. Реализации не должны изменить указанные временные объекты.
    Определенный:
    
    between в интерфейсе TemporalUnit
    
    Параметры:
    
    temporal1 - основной временный объект, не нуль
    
    temporal2 - другой временный объект, не нуль
    
    Возвраты:
    
    количество времени между temporal1 и temporal2 с точки зрения этого модуля; положительный, если temporal2 позже чем temporal1, отрицательный если ранее
  - toString
```
public String toString()
```
    Описание скопировало с class: Enum
    
    Возвращает имя этой перечислимой константы, как содержащийся в объявлении. Этот метод может быть переопределен, хотя это обычно не является необходимым или требуемым. Перечислимый тип должен переопределить этот метод, когда более "благоприятная для программиста" строковая форма существует.
    
    Определенный:
    
    toString в интерфейсе TemporalUnit
    
    Переопределения:
    
    toString в class Enum<ChronoUnit>
    
    Возвраты:
    
    имя этой перечислимой константы

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Перечислимый ChronoUnit

Перечислимая Постоянная Сводка

Сводка метода

Методы, наследованные от class java.lang. Перечисление

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

Перечислимая Постоянная Деталь

NANOS

MICROS

MILLIS

СЕКУНДЫ

МИНУТЫ

ЧАСЫ

HALF_DAYS

ДНИ

НЕДЕЛИ

МЕСЯЦЫ

ГОДЫ

ДЕСЯТИЛЕТИЯ

СТОЛЕТИЯ

ТЫСЯЧЕЛЕТИЯ

ERA

НАВСЕГДА

Деталь метода

значения

valueOf

getName

getDuration

isDurationEstimated

isDateUnit

isTimeUnit

isSupportedBy

addTo

между

toString