Класс Duration

public static final Duration ZERO

public static final Duration MIN

Примечание к API:

Эта константа представляет наименьший возможный экземпляр Duration. Поскольку Duration имеет направленность, наименьшая возможная длительность является отрицательной. Константа предназначена для использования в качестве маркера или в тестах. При выполнении арифметических операций с MIN следует соблюдать осторожность, так как существует высокий риск возникновения исключения ArithmeticException или DateTimeException.

Начиная с версии:

26

public static final Duration MAX

Примечание к API:

Эта константа представляет наибольший возможный экземпляр Duration. Константа предназначена для использования в качестве маркера или в тестах. При выполнении арифметических операций с MAX следует соблюдать осторожность, так как существует высокий риск возникновения исключения ArithmeticException или DateTimeException.

Начиная с версии:

26

public static Duration ofDays(long days)

Параметры:

days — количество суток, положительное или отрицательное

Возвращает:

Duration, не null

Выбрасывает:

ArithmeticException — если количество суток во входном значении превышает вместимость Duration

public static Duration ofHours(long hours)

Параметры:

hours — количество часов, положительное или отрицательное

Возвращает:

Duration, не null

Выбрасывает:

ArithmeticException — если количество часов во входном значении превышает вместимость Duration

public static Duration ofMinutes(long minutes)

Параметры:

minutes — количество минут, положительное или отрицательное

Возвращает:

Duration, не null

Выбрасывает:

ArithmeticException — если количество минут во входном значении превышает вместимость Duration

public static Duration ofSeconds(long seconds)

Параметры:

seconds — количество секунд, положительное или отрицательное

Возвращает:

Duration, не null

public static Duration ofSeconds(long seconds, long nanoAdjustment)

 Duration.ofSeconds(3, 1);
 Duration.ofSeconds(4, -999_999_999);
 Duration.ofSeconds(2, 1000_000_001);

Параметры:

seconds — количество секунд, положительное или отрицательное

nanoAdjustment — поправка в наносекундах к количеству секунд, положительная или отрицательная

Возвращает:

Duration, не null

Выбрасывает:

ArithmeticException — если поправка приводит к превышению вместимости Duration количеством секунд

public static Duration ofMillis(long millis)

Параметры:

millis — количество миллисекунд, положительное или отрицательное

Возвращает:

Duration, не null

public static Duration ofNanos(long nanos)

Параметры:

nanos — количество наносекунд, положительное или отрицательное

Возвращает:

Duration, не null

public static Duration of(long amount, TemporalUnit unit)

 Duration.of(3, SECONDS);
 Duration.of(465, HOURS);

Параметры:

amount — величина длительности в указанной единице измерения, положительная или отрицательная

unit — единица измерения длительности; должна иметь точную длительность, не null

Возвращает:

Duration, не null

Выбрасывает:

DateTimeException — если длительность единицы измерения является приблизительной

ArithmeticException — при числовом переполнении

public static Duration from(TemporalAmount amount)

Параметры:

amount — временная величина для преобразования, не null

Возвращает:

эквивалентную длительность, не null

Выбрасывает:

DateTimeException — если не удалось преобразовать в Duration

ArithmeticException — при числовом переполнении

public static Duration parse(CharSequence text)

   "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 3,600 seconds)
   "P2D"       -- parses as "2 days" (where a day is 24 hours or 86,400 seconds)
   "P2DT3H4M"  -- parses as "2 days, 3 hours and 4 minutes"
   "PT-6H3M"    -- parses as "-6 hours and +3 minutes"
   "-PT6H3M"    -- parses as "-6 hours and -3 minutes"
   "-PT-6H+3M"  -- parses as "+6 hours and -3 minutes"

Параметры:

text — текст для анализа, не null

Возвращает:

проанализированную длительность, не null

Выбрасывает:

DateTimeParseException — если текст не удалось преобразовать в длительность

public static Duration between(Temporal startInclusive, Temporal endExclusive)

Параметры:

startInclusive — начальный момент, включительно, не null

endExclusive — конечный момент, исключительно, не null

Возвращает:

Duration, не null

Выбрасывает:

DateTimeException — если невозможно получить количество секунд между временными объектами

ArithmeticException — если результат вычисления превышает вместимость Duration

public long get(TemporalUnit unit)

Определено в:

get в интерфейсе TemporalAmount

Параметры:

unit — TemporalUnit, значение которой требуется вернуть

Возвращает:

значение единицы измерения типа long

Выбрасывает:

DateTimeException — если единица измерения не поддерживается

UnsupportedTemporalTypeException — если единица измерения не поддерживается

public List<TemporalUnit> getUnits()

Определено в:

getUnits в интерфейсе TemporalAmount

Возвращает:

список, содержащий единицы секунд и наносекунд, не null

public boolean isPositive()

Возвращает:

true, если общая длительность больше нуля

Начиная с версии:

18

public boolean isZero()

Возвращает:

true, если общая длительность равна нулю

public boolean isNegative()

Возвращает:

true, если общая длительность меньше нуля

public long getSeconds()

Возвращает:

целая часть длительности в секундах, положительная или отрицательная

public int getNano()

Возвращает:

количество наносекунд в секундной части длительности, от 0 до 999 999 999

public Duration withSeconds(long seconds)

Параметры:

seconds — количество секунд, может быть отрицательным

Возвращает:

Duration на основе этой длительности с заданным количеством секунд, не null

public Duration withNanos(int nanoOfSecond)

Параметры:

nanoOfSecond — значение наносекунд в секунде, от 0 до 999 999 999

Возвращает:

Duration на основе этой длительности с заданным значением наносекунд в секунде, не null

Выбрасывает:

DateTimeException — если значение наносекунд в секунде недопустимо

public Duration plus(Duration duration)

Параметры:

duration — длительность для прибавления, положительная или отрицательная, не null

Возвращает:

Duration на основе этой длительности, увеличенной на указанную длительность, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration plus(long amountToAdd, TemporalUnit unit)

Параметры:

amountToAdd — величина для прибавления, измеренная в указанной единице, положительная или отрицательная

unit — единица измерения величины; должна иметь точную длительность, не null

Возвращает:

Duration на основе этой длительности, увеличенной на указанную длительность, не null

Выбрасывает:

UnsupportedTemporalTypeException — если единица измерения не поддерживается

ArithmeticException — при числовом переполнении

public Duration plusDays(long daysToAdd)

Параметры:

daysToAdd — количество суток для прибавления, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, увеличенной на указанное количество суток, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration plusHours(long hoursToAdd)

Параметры:

hoursToAdd — количество часов для прибавления, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, увеличенной на указанное количество часов, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration plusMinutes(long minutesToAdd)

Параметры:

minutesToAdd — количество минут для прибавления, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, увеличенной на указанное количество минут, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration plusSeconds(long secondsToAdd)

Параметры:

secondsToAdd — количество секунд для прибавления, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, увеличенной на указанное количество секунд, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration plusMillis(long millisToAdd)

Параметры:

millisToAdd — количество миллисекунд для прибавления, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, увеличенной на указанное количество миллисекунд, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration plusNanos(long nanosToAdd)

Параметры:

nanosToAdd — количество наносекунд для прибавления, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, увеличенной на указанное количество наносекунд, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration minus(Duration duration)

Параметры:

duration — длительность для вычитания, положительная или отрицательная, не null

Возвращает:

Duration на основе этой длительности, уменьшенной на указанную длительность, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration minus(long amountToSubtract, TemporalUnit unit)

Параметры:

amountToSubtract — величина для вычитания, измеренная в указанной единице, положительная или отрицательная

unit — единица измерения величины; должна иметь точную длительность, не null

Возвращает:

Duration на основе этой длительности, уменьшенной на указанную длительность, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration minusDays(long daysToSubtract)

Параметры:

daysToSubtract — количество суток для вычитания, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, уменьшенной на указанное количество суток, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration minusHours(long hoursToSubtract)

Параметры:

hoursToSubtract — количество часов для вычитания, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, уменьшенной на указанное количество часов, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration minusMinutes(long minutesToSubtract)

Параметры:

minutesToSubtract — количество минут для вычитания, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, уменьшенной на указанное количество минут, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration minusSeconds(long secondsToSubtract)

Параметры:

secondsToSubtract — количество секунд для вычитания, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, уменьшенной на указанное количество секунд, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration minusMillis(long millisToSubtract)

Параметры:

millisToSubtract — количество миллисекунд для вычитания, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, уменьшенной на указанное количество миллисекунд, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration minusNanos(long nanosToSubtract)

Параметры:

nanosToSubtract — количество наносекунд для вычитания, положительное или отрицательное

Возвращает:

Duration на основе этой длительности, уменьшенной на указанное количество наносекунд, не null

Выбрасывает:

ArithmeticException — при числовом переполнении

public Duration multipliedBy(long multiplicand)

Параметры:

multiplicand — значение, на которое умножается длительность; положительное или отрицательное

Возвращает:

Duration на основе этой длительности, умноженной на указанный скаляр; не null

Вызывает исключение:

ArithmeticException — если происходит переполнение числового значения

public Duration dividedBy(long divisor)

Параметры:

divisor — значение, на которое делится длительность; положительное или отрицательное, не равное нулю

Возвращает:

Duration на основе этой длительности, разделённой на указанный делитель; не null

Вызывает исключение:

ArithmeticException — если делитель равен нулю или происходит переполнение числового значения

public long dividedBy(Duration divisor)

Параметры:

divisor — значение, на которое делится длительность; положительное или отрицательное, не null

Возвращает:

количество целых раз, округлённое к нулю, которое указанная Duration укладывается в эту длительность; может быть отрицательным

Вызывает исключение:

ArithmeticException — если делитель равен нулю или происходит переполнение числового значения

Начиная с:

9

public Duration negated()

Возвращает:

Duration на основе этой длительности с количеством, имеющим противоположный знак; не null

Вызывает исключение:

ArithmeticException — если происходит переполнение числового значения

public Duration abs()

Возвращает:

Duration на основе этой длительности с абсолютным значением; не null

Вызывает исключение:

ArithmeticException — если происходит переполнение числового значения

public Temporal addTo(Temporal temporal)

  // these two lines are equivalent, but the second approach is recommended
  dateTime = thisDuration.addTo(dateTime);
  dateTime = dateTime.plus(thisDuration);

Указано в:

addTo в интерфейсе TemporalAmount

Параметры:

temporal — временной объект для корректировки; не null

Возвращает:

объект того же типа с выполненной корректировкой; не null

Вызывает исключение:

DateTimeException — если выполнить сложение невозможно

ArithmeticException — если происходит переполнение числового значения

public Temporal subtractFrom(Temporal temporal)

  // these two lines are equivalent, but the second approach is recommended
  dateTime = thisDuration.subtractFrom(dateTime);
  dateTime = dateTime.minus(thisDuration);

Указано в:

subtractFrom в интерфейсе TemporalAmount

Параметры:

temporal — временной объект для корректировки; не null

Возвращает:

объект того же типа с выполненной корректировкой; не null

Вызывает исключение:

DateTimeException — если выполнить вычитание невозможно

ArithmeticException — если происходит переполнение числового значения

public long toDays()

Возвращает:

количество дней в длительности; может быть отрицательным

public long toHours()

Возвращает:

количество часов в длительности; может быть отрицательным

public long toMinutes()

Возвращает:

количество минут в длительности; может быть отрицательным

public long toSeconds()

Возвращает:

целую часть длительности в секундах; положительную или отрицательную

Начиная с:

9

public long toMillis()

Возвращает:

общая длительность в миллисекундах

Вызывает исключение:

ArithmeticException — если происходит переполнение числового значения

public long toNanos()

Возвращает:

общая длительность в наносекундах

Вызывает исключение:

ArithmeticException — если происходит переполнение числового значения

public long toDaysPart()

Примечание по API:

Этот метод работает точно так же, как toDays().

Возвращает:

количество дней в длительности; может быть отрицательным

Начиная с:

9

public int toHoursPart()

Возвращает:

часть длительности, выраженную в часах; может быть отрицательной

Начиная с:

9

public int toMinutesPart()

Возвращает:

часть длительности, выраженную в минутах; может быть отрицательной

Начиная с:

9

public int toSecondsPart()

Возвращает:

часть длительности, выраженную в секундах; может быть отрицательной

Начиная с:

9

public int toMillisPart()

Возвращает:

часть длительности, выраженную в миллисекундах.

Начиная с:

9

public int toNanosPart()

Возвращает:

количество наносекунд в секундной части длительности, от 0 до 999 999 999

Начиная с:

9

public Duration truncatedTo(TemporalUnit unit)

Параметры:

unit — единица измерения, до которой нужно усечь значение; не null

Возвращает:

Duration на основе этой длительности с усечённым временем; не null

Вызывает исключение:

DateTimeException — если единица измерения недопустима для усечения

UnsupportedTemporalTypeException — если единица измерения не поддерживается

Начиная с:

9

public int compareTo(Duration otherDuration)

Указано в:

compareTo в интерфейсе Comparable<Duration>

Параметры:

otherDuration — другая длительность для сравнения; не null

Возвращает:

значение сравнения: меньше нуля, если эта длительность меньше otherDuration; ноль, если они равны; больше нуля, если эта длительность больше otherDuration

public boolean equals(Object other)

Переопределяет:

equals в классе Object

Параметры:

other — другая длительность; null возвращает false

Возвращает:

true, если другая длительность равна этой

См. также:

• Object.hashCode()
• HashMap

public int hashCode()

Переопределяет:

hashCode в классе Object

Возвращает:

подходящий хеш-код

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(Object)

public String toString()

   "20.345 seconds"                 -- "PT20.345S"
   "15 minutes" (15 * 60 seconds)   -- "PT15M"
   "10 hours" (10 * 3,600 seconds)  -- "PT10H"
   "2 days" (2 * 86,400 seconds)    -- "PT48H"

Переопределяет:

toString в классе Object

Возвращает:

представление этой длительности в формате ISO-8601; не null