Продолжительность (Платформа Java SE 8 b92)

java.lang. Объект
- java.time. Продолжительность

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

Сериализуемый, Сопоставимый <Продолжительность>, TemporalAmount
```
public final class Duration
extends Object
implements TemporalAmount, Comparable<Duration>, Serializable
```
Основанное на времени количество времени, такое как '34.5 секунды.
Этот class моделирует количество или количество времени с точки зрения секунд и наносекунд. К этому можно получить доступ, используя другие основанные на продолжительности модули, такие как минуты и часы. Кроме того, DAYS модуль может использоваться и обрабатывается как точно равный 24 часам, таким образом игнорируя эффекты перехода на летнее время. См. Period для основанного на дате эквивалента этому class.
Физическая продолжительность могла иметь бесконечную длину. Для практичности продолжительность сохранена ограничениями, подобными Instant. Продолжительность использует разрешение наносекунды с максимальным значением секунд, которые могут быть сохранены в a long. Это больше чем ток оцененный возраст вселенной.
Диапазон продолжительности требует хранения числа, больше чем a long. Чтобы достигнуть этого, class хранит a long представление секунд и int представление наносекунды-секундного, которая всегда будет между 0 и 999 999 999. Модель имеет направленную продолжительность, означая, что продолжительность может быть отрицательной.
Продолжительность измеряется в "секундах", но они не обязательно идентичны научному "SI второе" определение, основанное на атомарных часах. Это различие только воздействует на продолжительности, измеренные около с секундой прыжка, и не должно влиять на большинство приложений. См. Instant для обсуждения относительно значения вторых и масштабов времени.

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

Этот class является неизменным и ориентированным на многопотоковое исполнение.

С тех пор:

1.8

См. Также:

Сериализированная Форма

Полевая Сводка

Поля
Модификатор и Тип Поле и Описание

static Duration НУЛЬ
Постоянный для продолжительности нуля.

Поля
Модификатор и Тип	Поле и Описание
`static Duration`	`НУЛЬ` Постоянный для продолжительности нуля.

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

Все Методы Статические Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`Продолжительность`	`abs()` Возвращает копию этой продолжительности с положительной длиной.
`Временный`	`addTo(Temporal temporal)` Добавляет эта продолжительность к указанному временному объекту.
`static Duration`	`between(Temporal startInclusive, Temporal endExclusive)` Получает a `Duration` представление продолжительности между двумя моментами.
`int`	`compareTo(Duration otherDuration)` Сравнивает эту продолжительность с указанным `Duration`.
`Продолжительность`	`dividedBy(long divisor)` Возвращает копию этой продолжительности, разделенной на указанное значение.
`boolean`	`equals(Object otherDuration)` Проверки, если эта продолжительность равна указанному `Duration`.
`static Duration`	`from(TemporalAmount amount)` Получает экземпляр `Duration` от временного количества.
`long`	`get(TemporalUnit unit)` Получает значение требуемого модуля.
`int`	`getNano()` Получает число наносекунд в пределах второго в этой продолжительности.
`long`	`getSeconds()` Получает число секунд в этой продолжительности.
`List<TemporalUnit>`	`getUnits()` Получает набор модулей, поддерживаемых этой продолжительностью.
`int`	`hashCode()` Хэш-код для этой продолжительности.
`boolean`	`isNegative()` Проверки, если эта продолжительность отрицательна, исключая нуль.
`boolean`	`isZero()` Проверки, если эта продолжительность является нулевой длиной.
`Продолжительность`	`minus(Duration duration)` Возвращает копию этой продолжительности с указанной вычтенной продолжительностью.
`Продолжительность`	`minus(long amountToSubtract, TemporalUnit unit)` Возвращает копию этой продолжительности с указанной вычтенной продолжительностью.
`Продолжительность`	`minusDays(long daysToSubtract)` Возвращает копию этой продолжительности с указанной продолжительностью, в стандартные 24-часовые дни вычтенной.
`Продолжительность`	`minusHours(long hoursToSubtract)` Возвращает копию этой продолжительности с указанной продолжительностью в вычтенных часах.
`Продолжительность`	`minusMillis(long millisToSubtract)` Возвращает копию этой продолжительности с указанной продолжительностью в вычтенных миллисекундах.
`Продолжительность`	`minusMinutes(long minutesToSubtract)` Возвращает копию этой продолжительности с указанной продолжительностью в вычтенных минутах.
`Продолжительность`	`minusNanos(long nanosToSubtract)` Возвращает копию этой продолжительности с указанной продолжительностью в вычтенных наносекундах.
`Продолжительность`	`minusSeconds(long secondsToSubtract)` Возвращает копию этой продолжительности с указанной продолжительностью в вычтенных секундах.
`Продолжительность`	`multipliedBy(long multiplicand)` Возвращает копию этой продолжительности, умноженной на скаляр.
`Продолжительность`	`negated()` Возвращает копию этой продолжительности с отрицаемой длиной.
`static Duration`	`of(long amount, TemporalUnit unit)` Получает a `Duration` представление количества в указанном модуле.
`static Duration`	`ofDays(long days)` Получает a `Duration` представление многих стандартных 24-часовых дней.
`static Duration`	`ofHours(long hours)` Получает a `Duration` представление многих стандартных часов.
`static Duration`	`ofMillis(long millis)` Получает a `Duration` представление многих миллисекунд.
`static Duration`	`ofMinutes(long minutes)` Получает a `Duration` представление многих стандартных минут.
`static Duration`	`ofNanos(long nanos)` Получает a `Duration` представление многих наносекунд.
`static Duration`	`ofSeconds(long seconds)` Получает a `Duration` представление многих секунд.
`static Duration`	`ofSeconds(long seconds, long nanoAdjustment)` Получает a `Duration` представление многих секунд и корректировки в наносекундах.
`static Duration`	`parse(CharSequence text)` Получает a `Duration` от текстовой строки такой как `PnDTnHnMn.nS`.
`Продолжительность`	`plus(Duration duration)` Возвращает копию этой продолжительности с указанной добавленной продолжительностью.
`Продолжительность`	`plus(long amountToAdd, TemporalUnit unit)` Возвращает копию этой продолжительности с указанной добавленной продолжительностью.
`Продолжительность`	`plusDays(long daysToAdd)` Возвращает копию этой продолжительности с указанной продолжительностью, в стандартные 24-часовые дни добавленной.
`Продолжительность`	`plusHours(long hoursToAdd)` Возвращает копию этой продолжительности с указанной продолжительностью в добавленных часах.
`Продолжительность`	`plusMillis(long millisToAdd)` Возвращает копию этой продолжительности с указанной продолжительностью в добавленных миллисекундах.
`Продолжительность`	`plusMinutes(long minutesToAdd)` Возвращает копию этой продолжительности с указанной продолжительностью в добавленных минутах.
`Продолжительность`	`plusNanos(long nanosToAdd)` Возвращает копию этой продолжительности с указанной продолжительностью в добавленных наносекундах.
`Продолжительность`	`plusSeconds(long secondsToAdd)` Возвращает копию этой продолжительности с указанной продолжительностью в добавленных секундах.
`Временный`	`subtractFrom(Temporal temporal)` Вычитает эту продолжительность из указанного временного объекта.
`long`	`toDays()` Получает число минут в этой продолжительности.
`long`	`toHours()` Получает число минут в этой продолжительности.
`long`	`toMillis()` Преобразовывает эту продолжительность в полную длину в миллисекундах.
`long`	`toMinutes()` Получает число минут в этой продолжительности.
`long`	`toNanos()` Преобразовывает эту продолжительность в полную длину в наносекундах, выраженных как a `long`.
`Строка`	`toString()` Строковое представление этой продолжительности, используя секунды ISO 8601 базируемое представление, такой как `PT8H6M12.345S`.
`Продолжительность`	`withNanos(int nanoOfSecond)` Возвращает копию этой продолжительности с указанным nano-of-second.
`Продолжительность`	`withSeconds(long seconds)` Возвращает копию этой продолжительности с указанным количеством секунд.

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

- Полевая Деталь
  - НУЛЬ
```
public static final Duration ZERO
```
    Постоянный для продолжительности нуля.
- Деталь метода
  - ofDays
```
public static Duration ofDays(long days)
```
    Получает a Duration представление многих стандартных 24-часовых дней.
    Секунды вычисляются основанные на стандартном определении дня, где каждый день составляет 86400 секунд, который подразумевает 24-часовой день. Наносекунда во втором поле обнуляется.
    
    Параметры:
    
    days - число дней, положительных или отрицательных
    
    Возвраты:
    
    a Duration, не нуль
    
    Броски:
    
    ArithmeticException - если входные дни превышают емкость Duration
  - ofHours
```
public static Duration ofHours(long hours)
```
    Получает a Duration представление многих стандартных часов.
    Секунды вычисляются основанные на стандартном определении часа, где каждый час составляет 3600 секунд. Наносекунда во втором поле обнуляется.
    
    Параметры:
    
    hours - число часов, положительных или отрицательных
    
    Возвраты:
    
    a Duration, не нуль
    
    Броски:
    
    ArithmeticException - если входные часы превышают емкость Duration
  - ofMinutes
```
public static Duration ofMinutes(long minutes)
```
    Получает a Duration представление многих стандартных минут.
    Секунды вычисляются основанные на стандартном определении минуты, где каждая минута составляет 60 секунд. Наносекунда во втором поле обнуляется.
    
    Параметры:
    
    minutes - число минут, положительных или отрицательных
    
    Возвраты:
    
    a Duration, не нуль
    
    Броски:
    
    ArithmeticException - если входные минуты превышают емкость Duration
  - ofSeconds
```
public static Duration ofSeconds(long seconds)
```
    Получает a Duration представление многих секунд.
    Наносекунда во втором поле обнуляется.
    
    Параметры:
    
    seconds - число секунд, положительных или отрицательных
    
    Возвраты:
    
    a Duration, не нуль
  - ofSeconds
```
public static Duration ofSeconds(long seconds,
                                 long nanoAdjustment)
```
    Получает a Duration представление многих секунд и корректировки в наносекундах.
    Этот метод позволяет произвольному числу наносекунд быть переданным в. Фабрика изменит значения второго и наносекунда, чтобы гарантировать, что сохраненная наносекунда находится в диапазоне от 0 до 999 999 999. Например, следующее приведет к точно та же самая продолжительность:
```
  Duration.ofSeconds(3, 1);
  Duration.ofSeconds(4, -999_999_999);
  Duration.ofSeconds(2, 1000_000_001);
 
```
    Параметры:
    
    seconds - число секунд, положительных или отрицательных
    
    nanoAdjustment - корректировка наносекунды числа секунд, положительных или отрицательных
    
    Возвраты:
    
    a Duration, не нуль
    
    Броски:
    
    ArithmeticException - если корректировка заставляет секунды превышать емкость Duration
  - ofMillis
```
public static Duration ofMillis(long millis)
```
    Получает a Duration представление многих миллисекунд.
    Секунды и наносекунды извлекаются из указанных миллисекунд.
    
    Параметры:
    
    millis - число миллисекунд, положительных или отрицательных
    
    Возвраты:
    
    a Duration, не нуль
  - ofNanos
```
public static Duration ofNanos(long nanos)
```
    Получает a Duration представление многих наносекунд.
    С указанных наносекунд извлекаются секунды и наносекунды.
    
    Параметры:
    
    nanos - число наносекунд, положительных или отрицательных
    
    Возвраты:
    
    a Duration, не нуль
  - из
```
public static Duration of(long amount,
                          TemporalUnit unit)
```
    Получает a Duration представление количества в указанном модуле.
    Параметры представляют две части фразы как '6 Часов. Например:
```
  Duration.of(3, SECONDS);
  Duration.of(465, HOURS);
 
```
    Только подмножество модулей принимается этим методом. Модуль должен или иметь точную продолжительность или быть ChronoUnit.DAYS который обрабатывается как 24 часа. Другие модули выдают исключение.
    Параметры:
    
    amount - количество продолжительности, измеренной с точки зрения модуля, положительного или отрицательного
    
    unit - у модуля, в котором измеряется продолжительность, должна быть точная продолжительность, не нуль
    
    Возвраты:
    
    a Duration, не нуль
    
    Броски:
    
    DateTimeException - если у модуля периода есть предполагаемая продолжительность
    
    ArithmeticException - если числовое переполнение происходит
  - от
```
public static Duration from(TemporalAmount amount)
```
    Получает экземпляр Duration от временного количества.
    Это получает продолжительность, основанную на указанном количестве. A TemporalAmount представляет количество времени, которое может быть основано на дате или основано на времени, который эта фабрика извлекает к продолжительности.
    Циклы преобразования вокруг набора модулей от количества и использования продолжительность модуля, чтобы вычислить общее количество Duration. Только подмножество модулей принимается этим методом. Модуль должен или иметь точную продолжительность или быть ChronoUnit.DAYS который обрабатывается как 24 часа. Если какие-либо другие модули находятся тогда, исключение выдается.
    
    Параметры:
    
    amount - временное количество, чтобы преобразовать, не нуль
    
    Возвраты:
    
    эквивалентная продолжительность, не нуль
    
    Броски:
    
    DateTimeException - если неспособный преобразовать в a Duration
    
    ArithmeticException - если числовое переполнение происходит
  - синтаксический анализ
```
public static Duration parse(CharSequence text)
```
    Получает a Duration от текстовой строки такой как PnDTnHnMn.nS.
    Это проанализирует текстовое представление продолжительности, включая строку, произведенную toString(). Принятые форматы основаны на формате продолжительности ISO 8601 PnDTnHnMn.nS со днями, которые, как полагают, были точно 24 часами.
    Строка запускается с дополнительного знака, обозначенного ASCII отрицательный или положительный символ. Если отрицание, целый период отрицается. Буква "P" ASCII является следующей в верхнем регистре или нижнем регистре. Есть тогда четыре раздела, каждый состоящий из числа и суффикса. У разделов есть суффиксы в ASCII "D", "H", "M" и "S" в течение многих дней, часов, минут и секунд, принятых в верхнем регистре или нижнем регистре. Суффиксы должны произойти в порядке. Буква "T" ASCII должна произойти перед первым возникновением, если таковые вообще имеются, часа, минуты или второго раздела. По крайней мере один из этих четырех разделов должен присутствовать, и если "T" присутствует после "T" должен быть по крайней мере один раздел. Часть числа каждого раздела должна состоять из одной или более цифр ASCII. Число может быть снабжено префиксом ASCII отрицательный или положительный символ. Число дней, часов и минут должно проанализировать к long. Число секунд должно проанализировать к long с дополнительной частью. Десятичная точка может быть или точкой или запятой. Дробная часть может иметь от нуля до 9 цифр.
    Продвижение плюс/знак "минус", и отрицательные величины для других модулей не является частью стандарта ISO 8601.
    Примеры:
```
    "PT20.345S" -- parses as "20.345 seconds"
    "PT15M"     -- parses as "15 minutes" (where a minute is 60 seconds)
    "PT10H"     -- parses as "10 hours" (where an hour is 3600 seconds)
    "P2D"       -- parses as "2 days" (where a day is 24 hours or 86400 seconds)
    "P2DT3H4M"  -- parses as "2 days, 3 hours and 4 minutes"
    "P-6H3M"    -- parses as "-6 hours and +3 minutes"
    "-P6H3M"    -- parses as "-6 hours and -3 minutes"
    "-P-6H+3M"  -- parses as "+6 hours and -3 minutes"
 
```
    Параметры:
    
    text - текст, чтобы проанализировать, не нуль
    
    Возвраты:
    
    проанализированная продолжительность, не нуль
    
    Броски:
    
    DateTimeParseException - если текст не может быть проанализирован к продолжительности
  - между
```
public static Duration between(Temporal startInclusive,
                               Temporal endExclusive)
```
    Получает a Duration представление продолжительности между двумя моментами.
    Это вычисляет продолжительность между двумя временными объектами того же самого типа. Указанные временные объекты должны поддерживать SECONDS модуль. Для полной точности, любой NANOS модуль или NANO_OF_SECOND поле должно поддерживаться.
    Результатом этого метода может быть отрицательный период, если конец перед запуском. Гарантировать, что получили положительный вызов продолжительности abs() на результате.
    
    Параметры:
    
    startInclusive - момент запуска, включительно, не нуль
    
    endExclusive - конец, мгновенный, монопольный, не нулевой
    
    Возвраты:
    
    a Duration, не нуль
    
    Броски:
    
    DateTimeException - если секунды между temporals не могут быть получены
    
    ArithmeticException - если вычисление превышает емкость Duration
  - добраться
```
public long get(TemporalUnit unit)
```
    Получает значение требуемого модуля.
    Это возвращает значение для каждого из двух поддерживаемых модулей, SECONDS и NANOS. Все другие модули выдают исключение.
    
    Определенный:
    
    get в интерфейсе TemporalAmount
    
    Параметры:
    
    unit - TemporalUnit для которого можно возвратить значение
    
    Возвраты:
    
    длинное значение модуля
    
    Броски:
    
    DateTimeException - если модуль не поддерживается
    
    UnsupportedTemporalTypeException - если модуль не поддерживается
  - getUnits
```
public List<TemporalUnit> getUnits()
```
    Получает набор модулей, поддерживаемых этой продолжительностью.
    Поддерживаемые модули SECONDS, и NANOS. Они возвращаются в секунды порядка, nanos.
    Этот набор может использоваться в соединении с get(TemporalUnit) получить доступ ко всему состоянию периода.
    
    Определенный:
    
    getUnits в интерфейсе TemporalAmount
    
    Возвраты:
    
    список, содержащий секунды и nanos модули, не нуль
  - isZero
```
public boolean isZero()
```
    Проверки, если эта продолжительность является нулевой длиной.
    A Duration представляет направленное расстояние между двумя точками на временной шкале и может поэтому быть положительным, нуль или отрицательным. Этот метод проверяет, является ли длина нулем.
    
    Возвраты:
    
    истина, если у этой продолжительности есть полная длина, равная нулю
  - isNegative
```
public boolean isNegative()
```
    Проверки, если эта продолжительность отрицательна, исключая нуль.
    A Duration представляет направленное расстояние между двумя точками на временной шкале и может поэтому быть положительным, нуль или отрицательным. Этот метод проверяет, является ли длина меньше чем нуль.
    
    Возвраты:
    
    истина, если у этой продолжительности есть полная длина меньше чем нуль
  - getSeconds
```
public long getSeconds()
```
    Получает число секунд в этой продолжительности.
    Продолжительность продолжительности сохранена, используя два поля - секунды и наносекунды. Часть наносекунд является значением от 0 до 999 999 999, который является корректировкой длины в секундах. Полная продолжительность определяется, вызывая этот метод и getNano().
    A Duration представляет направленное расстояние между двумя точками на временной шкале. Отрицательная продолжительность выражается знаком минус части секунд. Продолжительность-1 наносекунды сохранена как-1 секунда плюс 999 999 999 наносекунд.
    
    Возвраты:
    
    целая часть секунд продолжительности продолжительности, положительной или отрицательной
  - getNano
```
public int getNano()
```
    Получает число наносекунд в пределах второго в этой продолжительности.
    Продолжительность продолжительности сохранена, используя два поля - секунды и наносекунды. Часть наносекунд является значением от 0 до 999 999 999, который является корректировкой длины в секундах. Полная продолжительность определяется, вызывая этот метод и getSeconds().
    A Duration представляет направленное расстояние между двумя точками на временной шкале. Отрицательная продолжительность выражается знаком минус части секунд. Продолжительность-1 наносекунды сохранена как-1 секунда плюс 999 999 999 наносекунд.
    
    Возвраты:
    
    наносекунды в пределах второй части продолжительности продолжительности, от 0 до 999 999 999
  - withSeconds
```
public Duration withSeconds(long seconds)
```
    Возвращает копию этой продолжительности с указанным количеством секунд.
    Это возвращает продолжительность с указанными секундами, сохраняя nano-of-second часть этой продолжительности.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    seconds - секунды, чтобы представить, может быть отрицательным
    
    Возвраты:
    
    a Duration основанный на этом периоде с требуемыми секундами, не нуле
  - withNanos
```
public Duration withNanos(int nanoOfSecond)
```
    Возвращает копию этой продолжительности с указанным nano-of-second.
    Это возвращает продолжительность с указанным nano-of-second, сохраняя часть секунд этой продолжительности.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    nanoOfSecond - nano-of-second, чтобы представить, от 0 до 999 999 999
    
    Возвраты:
    
    a Duration основанный на этом периоде с требуемым nano-of-second, не нуле
    
    Броски:
    
    DateTimeException - если nano-of-second недопустим
  - плюс
```
public Duration plus(Duration duration)
```
    Возвращает копию этой продолжительности с указанной добавленной продолжительностью.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    duration - продолжительность, чтобы добавить, положительный или отрицательный, не нулевой
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанной продолжительностью добавил, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - плюс
```
public Duration plus(long amountToAdd,
                     TemporalUnit unit)
```
    Возвращает копию этой продолжительности с указанной добавленной продолжительностью.
    Количество продолжительности измеряется с точки зрения указанного модуля. Только подмножество модулей принимается этим методом. Модуль должен или иметь точную продолжительность или быть ChronoUnit.DAYS который обрабатывается как 24 часа. Другие модули выдают исключение.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    amountToAdd - количество периода, измеренного с точки зрения модуля, положительного или отрицательного
    
    unit - у модуля, в котором измеряется период, должна быть точная продолжительность, не нуль
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанной продолжительностью добавил, не нуль
    
    Броски:
    
    UnsupportedTemporalTypeException - если модуль не поддерживается
    
    ArithmeticException - если числовое переполнение происходит
  - plusDays
```
public Duration plusDays(long daysToAdd)
```
    Возвращает копию этой продолжительности с указанной продолжительностью, в стандартные 24-часовые дни добавленной.
    Число дней умножается на 86400, чтобы получить число секунд, чтобы добавить. Это основано на стандартном определении дня как 24 часа.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    daysToAdd - дни, чтобы добавить, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными днями добавил, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - plusHours
```
public Duration plusHours(long hoursToAdd)
```
    Возвращает копию этой продолжительности с указанной продолжительностью в добавленных часах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    hoursToAdd - часы, чтобы добавить, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными часами добавил, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - plusMinutes
```
public Duration plusMinutes(long minutesToAdd)
```
    Возвращает копию этой продолжительности с указанной продолжительностью в добавленных минутах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    minutesToAdd - минуты, чтобы добавить, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными минутами добавил, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - plusSeconds
```
public Duration plusSeconds(long secondsToAdd)
```
    Возвращает копию этой продолжительности с указанной продолжительностью в добавленных секундах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    secondsToAdd - секунды, чтобы добавить, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными секундами добавил, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - plusMillis
```
public Duration plusMillis(long millisToAdd)
```
    Возвращает копию этой продолжительности с указанной продолжительностью в добавленных миллисекундах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    millisToAdd - миллисекунды, чтобы добавить, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными миллисекундами добавил, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - plusNanos
```
public Duration plusNanos(long nanosToAdd)
```
    Возвращает копию этой продолжительности с указанной продолжительностью в добавленных наносекундах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    nanosToAdd - наносекунды, чтобы добавить, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными наносекундами добавил, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - минус
```
public Duration minus(Duration duration)
```
    Возвращает копию этой продолжительности с указанной вычтенной продолжительностью.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    duration - продолжительность, чтобы вычесть, положительный или отрицательный, не нулевой
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанной вычтенной продолжительностью, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - минус
```
public Duration minus(long amountToSubtract,
                      TemporalUnit unit)
```
    Возвращает копию этой продолжительности с указанной вычтенной продолжительностью.
    Количество продолжительности измеряется с точки зрения указанного модуля. Только подмножество модулей принимается этим методом. Модуль должен или иметь точную продолжительность или быть ChronoUnit.DAYS который обрабатывается как 24 часа. Другие модули выдают исключение.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    amountToSubtract - количество периода, измеренного с точки зрения модуля, положительного или отрицательного
    
    unit - у модуля, в котором измеряется период, должна быть точная продолжительность, не нуль
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанной вычтенной продолжительностью, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - minusDays
```
public Duration minusDays(long daysToSubtract)
```
    Возвращает копию этой продолжительности с указанной продолжительностью, в стандартные 24-часовые дни вычтенной.
    Число дней умножается на 86400, чтобы получить число секунд, чтобы вычесть. Это основано на стандартном определении дня как 24 часа.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    daysToSubtract - дни, чтобы вычесть, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными вычтенными днями, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - minusHours
```
public Duration minusHours(long hoursToSubtract)
```
    Возвращает копию этой продолжительности с указанной продолжительностью в вычтенных часах.
    Число часов умножается на 3600, чтобы получить число секунд, чтобы вычесть.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    hoursToSubtract - часы, чтобы вычесть, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными вычтенными часами, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - minusMinutes
```
public Duration minusMinutes(long minutesToSubtract)
```
    Возвращает копию этой продолжительности с указанной продолжительностью в вычтенных минутах.
    Число часов умножается на 60, чтобы получить число секунд, чтобы вычесть.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    minutesToSubtract - минуты, чтобы вычесть, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными вычтенными минутами, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - minusSeconds
```
public Duration minusSeconds(long secondsToSubtract)
```
    Возвращает копию этой продолжительности с указанной продолжительностью в вычтенных секундах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    secondsToSubtract - секунды, чтобы вычесть, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными вычтенными секундами, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - minusMillis
```
public Duration minusMillis(long millisToSubtract)
```
    Возвращает копию этой продолжительности с указанной продолжительностью в вычтенных миллисекундах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    millisToSubtract - миллисекунды, чтобы вычесть, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными вычтенными миллисекундами, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - minusNanos
```
public Duration minusNanos(long nanosToSubtract)
```
    Возвращает копию этой продолжительности с указанной продолжительностью в вычтенных наносекундах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    nanosToSubtract - наносекунды, чтобы вычесть, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с указанными вычтенными наносекундами, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - multipliedBy
```
public Duration multipliedBy(long multiplicand)
```
    Возвращает копию этой продолжительности, умноженной на скаляр.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    multiplicand - значение, чтобы умножить продолжительность на, положительный или отрицательный
    
    Возвраты:
    
    a Duration основанный на этой продолжительности, умноженной на указанный скаляр, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - dividedBy
```
public Duration dividedBy(long divisor)
```
    Возвращает копию этой продолжительности, разделенной на указанное значение.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    divisor - значение, чтобы разделить продолжительность на, положительный или отрицательный, не нуль
    
    Возвраты:
    
    a Duration основанный на этой продолжительности, разделенной на указанный делитель, не нуль
    
    Броски:
    
    ArithmeticException - если делитель является нулем или если числовое переполнение происходит
  - отрицаемый
```
public Duration negated()
```
    Возвращает копию этой продолжительности с отрицаемой длиной.
    Этот метод подкачивает знак полной продолжительности этой продолжительности. Например, PT1.3S будет возвращен как PT-1.3S.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с отрицаемым количеством, не нуль
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - abs
```
public Duration abs()
```
    Возвращает копию этой продолжительности с положительной длиной.
    Этот метод возвращает положительную продолжительность, эффективно удаляя знак из любой отрицательной полной длины. Например, PT-1.3S будет возвращен как PT1.3S.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Возвраты:
    
    a Duration основанный на этой продолжительности с абсолютной длиной, не нуле
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - addTo
```
public Temporal addTo(Temporal temporal)
```
    Добавляет эта продолжительность к указанному временному объекту.
    Это возвращает временный объект того же самого заметного типа как ввод с этой добавленной продолжительностью.
    В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании Temporal.plus(TemporalAmount).
```
   // these two lines are equivalent, but the second approach is recommended
   dateTime = thisDuration.addTo(dateTime);
   dateTime = dateTime.plus(thisDuration);
 
```
    Вычисление добавит секунды, тогда nanos. Только ненулевое количество будет добавлено.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    Определенный:
    
    addTo в интерфейсе TemporalAmount
    
    Параметры:
    
    temporal - временный объект скорректировать, не нуль
    
    Возвраты:
    
    объект того же самого типа с внесенной корректировкой, не нуль
    
    Броски:
    
    DateTimeException - если неспособный добавить
    
    ArithmeticException - если числовое переполнение происходит
  - subtractFrom
```
public Temporal subtractFrom(Temporal temporal)
```
    Вычитает эту продолжительность из указанного временного объекта.
    Это возвращает временный объект того же самого заметного типа как ввод с этой вычтенной продолжительностью.
    В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании Temporal.minus(TemporalAmount).
```
   // these two lines are equivalent, but the second approach is recommended
   dateTime = thisDuration.subtractFrom(dateTime);
   dateTime = dateTime.minus(thisDuration);
 
```
    Вычисление вычтет секунды, тогда nanos. Только ненулевое количество будет добавлено.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    Определенный:
    
    subtractFrom в интерфейсе TemporalAmount
    
    Параметры:
    
    temporal - временный объект скорректировать, не нуль
    
    Возвраты:
    
    объект того же самого типа с внесенной корректировкой, не нуль
    
    Броски:
    
    DateTimeException - если неспособный вычитать
    
    ArithmeticException - если числовое переполнение происходит
  - toDays
```
public long toDays()
```
    Получает число минут в этой продолжительности.
    Это возвращает общее количество минут в продолжительности, деля число секунд 86400. Это основано на стандартном определении дня как 24 часа.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Возвраты:
    
    число минут в продолжительности, может быть отрицательным
  - toHours
```
public long toHours()
```
    Получает число минут в этой продолжительности.
    Это возвращает общее количество минут в продолжительности, деля число секунд 3600.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Возвраты:
    
    число минут в продолжительности, может быть отрицательным
  - toMinutes
```
public long toMinutes()
```
    Получает число минут в этой продолжительности.
    Это возвращает общее количество минут в продолжительности, деля число секунд 60.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Возвраты:
    
    число минут в продолжительности, может быть отрицательным
  - toMillis
```
public long toMillis()
```
    Преобразовывает эту продолжительность в полную длину в миллисекундах.
    Если эта продолжительность является слишком большой, чтобы поместиться в a long миллисекунды, затем исключение выдается.
    Если эта продолжительность будет иметь больше чем точность миллисекунды, то преобразование отбросит любую избыточную информацию о точности, как если бы количество в наносекундах подвергалось целочисленному делению на один миллион.
    
    Возвраты:
    
    полная продолжительность продолжительности в миллисекундах
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - toNanos
```
public long toNanos()
```
    Преобразовывает эту продолжительность в полную длину в наносекундах, выраженных как a long.
    Если эта продолжительность является слишком большой, чтобы поместиться в a long наносекунды, затем исключение выдается.
    
    Возвраты:
    
    полная продолжительность продолжительности в наносекундах
    
    Броски:
    
    ArithmeticException - если числовое переполнение происходит
  - compareTo
```
public int compareTo(Duration otherDuration)
```
    Сравнивает эту продолжительность с указанным Duration.
    Сравнение основано на полной продолжительности продолжительностей. Это является "непротиворечивым с, равняется", как определено Comparable.
    
    Определенный:
    
    compareTo в интерфейсе Comparable<Duration>
    
    Параметры:
    
    otherDuration - другая продолжительность, чтобы сравнить с, не нуль
    
    Возвраты:
    
    значение компаратора, отрицательное, если меньше, положительный если больше
  - равняется
```
public boolean equals(Object otherDuration)
```
    Проверки, если эта продолжительность равна указанному Duration.
    Сравнение основано на полной продолжительности продолжительностей.
    
    Переопределения:
    
    equals в class Object
    
    Параметры:
    
    otherDuration - другая продолжительность, нуль возвращает false
    
    Возвраты:
    
    истина, если другая продолжительность равна этому
    
    См. Также:
    
    Object.hashCode(), HashMap
  - хэш-код
```
public int hashCode()
```
    Хэш-код для этой продолжительности.
    
    Переопределения:
    
    hashCode в class Object
    
    Возвраты:
    
    подходящий хэш-код
    
    См. Также:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    Строковое представление этой продолжительности, используя секунды ISO 8601 базируемое представление, такой как PT8H6M12.345S.
    Формат возвращенной строки будет PTnHnMnS, где n является соответствующими часами, минутами или частью секунд продолжительности. Любые доли секунды помещаются после десятичной точки i раздел секунд. Если у раздела есть нулевое значение, он опускается. У часов, минут и секунд все будет тот же самый знак.
    Примеры:
```
    "20.345 seconds"                 -- "PT20.345S
    "15 minutes" (15 * 60 seconds)   -- "PT15M"
    "10 hours" (10 * 3600 seconds)   -- "PT10H"
    "2 days" (2 * 86400 seconds)     -- "PT48H"
 
```
    Отметьте, что сеть магазинов 24 часов не выводится как дни, чтобы избежать беспорядка с Period.
    Переопределения:
    
    toString в class Object
    
    Возвраты:
    
    представление ISO 8601 этой продолжительности, не нуль

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

Продолжительность класса

Полевая Сводка

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

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

Полевая Деталь

НУЛЬ

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

ofDays

ofHours

ofMinutes

ofSeconds

ofSeconds

ofMillis

ofNanos

из

от

синтаксический анализ

между

добраться

getUnits

isZero

isNegative

getSeconds

getNano

withSeconds

withNanos

плюс

плюс

plusDays

plusHours

plusMinutes

plusSeconds

plusMillis

plusNanos

минус

минус

minusDays

minusHours

minusMinutes

minusSeconds

minusMillis

minusNanos

multipliedBy

dividedBy

отрицаемый

abs

addTo

subtractFrom

toDays

toHours

toMinutes

toMillis

toNanos

compareTo

равняется

хэш-код

toString