Класс Duration

public static final Duration ZERO

Константа для нулевой продолжительности.

public static Duration ofDays(long days)

Создает Duration, представляющую количество стандартных суток длительностью 24 часа.

Количество секунд вычисляется на основе стандартного определения суток: каждые сутки составляют 86400 секунд, то есть 24 часа. Поле наносекунд в секунде устанавливается в ноль.

public static Duration ofHours(long hours)

Создает Duration, представляющую количество стандартных часов.

Количество секунд вычисляется на основе стандартного определения часа: каждый час составляет 3600 секунд. Поле наносекунд в секунде устанавливается в ноль.

public static Duration ofMinutes(long minutes)

Создает Duration, представляющую количество стандартных минут.

Количество секунд вычисляется на основе стандартного определения минуты: каждая минута составляет 60 секунд. Поле наносекунд в секунде устанавливается в ноль.

public static Duration ofSeconds(long seconds)

Создает Duration, представляющую количество секунд.

Поле наносекунд в секунде устанавливается в ноль.

public static Duration ofSeconds(long seconds, long nanoAdjustment)

Создает Duration, представляющую количество секунд и поправку в наносекундах.

Этот метод позволяет передать произвольное количество наносекунд. Фабричный метод изменяет значения секунд и наносекунд, чтобы хранимое значение наносекунд находилось в диапазоне от 0 до 999,999,999. Например, следующие значения дают одинаковую продолжительность:

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

public static Duration ofMillis(long millis)

Создает Duration, представляющую количество миллисекунд.

Значения секунд и наносекунд извлекаются из указанного количества миллисекунд.

public static Duration ofNanos(long nanos)

Создает Duration, представляющую количество наносекунд.

Значения секунд и наносекунд извлекаются из указанного количества наносекунд.

public static Duration of(long amount, TemporalUnit unit)

Создает Duration, представляющую величину в указанных единицах.

Параметры представляют две части выражения, например «6 часов». Например:

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

Этот метод принимает только часть единиц измерения. Единица должна иметь точную продолжительность либо быть ChronoUnit.DAYS, которая считается равной 24 часам. Для других единиц возникает исключение.

public static Duration from(TemporalAmount amount)

Создает экземпляр Duration на основе временной величины.

Создает продолжительность на основе указанной величины. TemporalAmount представляет величину времени, которая может быть основана на дате или времени; этот фабричный метод преобразует ее в продолжительность.

При преобразовании выполняется перебор набора единиц величины, а продолжительность каждой единицы используется для вычисления общей величины Duration. Этот метод принимает только часть единиц измерения. Единица должна иметь точную продолжительность либо быть ChronoUnit.DAYS, которая считается равной 24 часам. Если обнаружены другие единицы, возникает исключение.

public static Duration parse(CharSequence text)

Создает Duration из текстовой строки, например PnDTnHnMn.nS.

Метод анализирует текстовое представление продолжительности, в том числе строку, созданную методом toString(). Допустимые форматы основаны на формате продолжительности ISO-8601 PnDTnHnMn.nS, где сутки считаются равными ровно 24 часам.

Строка начинается с необязательного знака — символа минуса или плюса ASCII. Если указан минус, вся продолжительность становится отрицательной. Далее следует латинская буква «P» в верхнем или нижнем регистре. Затем идут четыре секции, каждая из которых состоит из числа и суффикса. Суффиксы секций — символы ASCII «D», «H», «M» и «S», обозначающие сутки, часы, минуты и секунды; допускается верхний или нижний регистр. Суффиксы должны идти в указанном порядке. Перед первым появлением секции часов, минут или секунд (если такая секция есть) должна стоять латинская буква 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"
   "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"

public static Duration between(Temporal startInclusive, Temporal endExclusive)

Создает Duration, представляющую продолжительность между двумя временными объектами.

Вычисляет продолжительность между двумя временными объектами. Если объекты имеют разные типы, продолжительность вычисляется на основе типа первого объекта. Например, если первый аргумент — LocalTime, второй аргумент преобразуется в LocalTime.

Указанные временные объекты должны поддерживать единицу SECONDS. Для полной точности должна поддерживаться либо единица NANOS, либо поле NANO_OF_SECOND.

Результатом этого метода может быть отрицательная продолжительность, если конец предшествует началу. Чтобы гарантированно получить положительную продолжительность, вызовите для результата метод abs().

public long get(TemporalUnit unit)

Возвращает значение запрошенной единицы измерения.

Метод возвращает значение для каждой из двух поддерживаемых единиц: SECONDS и NANOS. Для всех остальных единиц возникает исключение.

public List<TemporalUnit> getUnits()

Возвращает набор единиц, поддерживаемых этой продолжительностью.

Поддерживаются единицы SECONDS и NANOS. Они возвращаются в следующем порядке: секунды, наносекунды.

Этот набор можно использовать вместе с методом get(TemporalUnit), чтобы получить все данные о продолжительности.

public boolean isPositive()

Проверяет, является ли продолжительность положительной, исключая нулевую.

Duration представляет направленное расстояние между двумя точками на временной шкале и поэтому может быть положительной, нулевой или отрицательной. Этот метод проверяет, больше ли ее длительность нуля.

public boolean isZero()

Проверяет, равна ли продолжительность нулю.

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

public boolean isNegative()

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

Duration представляет направленное расстояние между двумя точками на временной шкале и поэтому может быть положительной, нулевой или отрицательной. Этот метод проверяет, меньше ли ее длительность нуля.

public long getSeconds()

Возвращает количество секунд в этой продолжительности.

Длительность хранится в двух полях: секундах и наносекундах. Часть в наносекундах — это значение от 0 до 999,999,999, корректирующее длительность в секундах. Общая продолжительность определяется вызовом этого метода и метода getNano().

Duration представляет направленное расстояние между двумя точками на временной шкале. Отрицательная продолжительность выражается отрицательным знаком части в секундах. Продолжительность в -1 наносекунду хранится как -1 секунда плюс 999,999,999 наносекунд.

public int getNano()

Возвращает количество наносекунд в пределах секунды этой продолжительности.

Длительность хранится в двух полях: секундах и наносекундах. Часть в наносекундах — это значение от 0 до 999,999,999, корректирующее длительность в секундах. Общая продолжительность определяется вызовом этого метода и метода getSeconds().

Duration представляет направленное расстояние между двумя точками на временной шкале. Отрицательная продолжительность выражается отрицательным знаком части в секундах. Продолжительность в -1 наносекунду хранится как -1 секунда плюс 999,999,999 наносекунд.

public Duration withSeconds(long seconds)

Возвращает копию этой продолжительности с указанным количеством секунд.

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

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration withNanos(int nanoOfSecond)

Возвращает копию этой продолжительности с указанным количеством наносекунд внутри секунды.

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

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration plus(Duration duration)

Возвращает копию этой продолжительности с добавленной указанной продолжительностью.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration plus(long amountToAdd, TemporalUnit unit)

Возвращает копию этой продолжительности с добавленной указанной продолжительностью.

Величина продолжительности измеряется в указанных единицах. Этот метод принимает только часть единиц измерения. Единица должна иметь точную продолжительность либо быть ChronoUnit.DAYS, которая считается равной 24 часам. Для других единиц возникает исключение.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration plusDays(long daysToAdd)

Возвращает копию этой продолжительности с добавленной указанной продолжительностью в стандартных сутках по 24 часа.

Количество суток умножается на 86400, чтобы получить количество добавляемых секунд. Это основано на стандартном определении суток как 24 часов.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration plusHours(long hoursToAdd)

Возвращает копию этой продолжительности с добавленной указанной продолжительностью в часах.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration plusMinutes(long minutesToAdd)

Возвращает копию этой продолжительности с добавленной указанной продолжительностью в минутах.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration plusSeconds(long secondsToAdd)

Возвращает копию этой продолжительности с добавленной указанной продолжительностью в секундах.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration plusMillis(long millisToAdd)

Возвращает копию этой продолжительности с добавленной указанной продолжительностью в миллисекундах.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration plusNanos(long nanosToAdd)

Возвращает копию этой продолжительности с добавленной указанной продолжительностью в наносекундах.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration minus(Duration duration)

Возвращает копию этой продолжительности с вычтенной указанной продолжительностью.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration minus(long amountToSubtract, TemporalUnit unit)

Возвращает копию этой продолжительности с вычтенной указанной продолжительностью.

Величина продолжительности измеряется в указанных единицах. Этот метод принимает только часть единиц измерения. Единица должна иметь точную продолжительность либо быть ChronoUnit.DAYS, которая считается равной 24 часам. Для других единиц возникает исключение.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration minusDays(long daysToSubtract)

Возвращает копию этой продолжительности с вычтенной указанной продолжительностью в стандартных сутках по 24 часа.

Количество суток умножается на 86400, чтобы получить количество вычитаемых секунд. Это основано на стандартном определении суток как 24 часов.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration minusHours(long hoursToSubtract)

Возвращает копию этой продолжительности с вычтенной указанной продолжительностью в часах.

Количество часов умножается на 3600, чтобы получить количество вычитаемых секунд.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration minusMinutes(long minutesToSubtract)

Возвращает копию этой продолжительности с вычтенной указанной продолжительностью в минутах.

Количество часов умножается на 60, чтобы получить количество вычитаемых секунд.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration minusSeconds(long secondsToSubtract)

Возвращает копию этой продолжительности с вычтенной указанной продолжительностью в секундах.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration minusMillis(long millisToSubtract)

Возвращает копию этой продолжительности с вычтенной указанной продолжительностью в миллисекундах.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration minusNanos(long nanosToSubtract)

Возвращает копию этой продолжительности с вычтенной указанной продолжительностью в наносекундах.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration multipliedBy(long multiplicand)

Возвращает копию этой продолжительности, умноженной на скаляр.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public Duration dividedBy(long divisor)

Возвращает копию этой продолжительности, разделенной на указанное значение.

Этот экземпляр неизменяем, и вызов метода не изменяет его.

public long dividedBy(Duration divisor)

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

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

public Duration negated()

Возвращает копию этой длительности с противоположным знаком.

Этот метод меняет знак общей длительности на противоположный. Например, PT1.3S будет возвращено как PT-1.3S.

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

public Duration abs()

Возвращает копию этой длительности с положительным значением.

Этот метод возвращает положительную длительность, фактически удаляя знак у отрицательного общего значения. Например, PT-1.3S будет возвращено как PT1.3S.

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

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

При вычислении сначала будут добавлены секунды, а затем наносекунды. Добавляются только ненулевые значения.

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

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

При вычислении сначала будут вычтены секунды, а затем наносекунды. Добавляются только ненулевые значения.

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

public long toDays()

Возвращает количество дней в этой длительности.

Возвращает общее количество дней в длительности, деля количество секунд на 86400. Расчёт основан на стандартном определении дня как 24 часов.

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

public long toHours()

Возвращает количество часов в этой длительности.

Возвращает общее количество часов в длительности, деля количество секунд на 3600.

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

public long toMinutes()

Возвращает количество минут в этой длительности.

Возвращает общее количество минут в длительности, деля количество секунд на 60.

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

public long toSeconds()

Возвращает количество секунд в этой длительности.

Возвращает общее количество полных секунд в длительности.

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

public long toMillis()

Преобразует эту длительность в общее количество миллисекунд.

Если эта длительность слишком велика, чтобы уместиться в long миллисекунд, будет выброшено исключение.

Если точность этой длительности выше миллисекундной, при преобразовании будут отброшены лишние данные о точности, как если бы количество наносекунд делилось на миллион с округлением до целого.

public long toNanos()

Преобразует эту длительность в общее количество наносекунд, представленное типом long.

Если эта длительность слишком велика, чтобы уместиться в long наносекунд, будет выброшено исключение.

public long toDaysPart()

Извлекает количество дней из длительности.

Возвращает общее количество дней в длительности, деля количество секунд на 86400. Расчёт основан на стандартном определении дня как 24 часов.

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

public int toHoursPart()

Извлекает часовую часть длительности.

Возвращает количество оставшихся часов после деления toHours() на количество часов в сутках. Расчёт основан на стандартном определении дня как 24 часов.

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

public int toMinutesPart()

Извлекает минутную часть длительности.

Возвращает количество оставшихся минут после деления toMinutes() на количество минут в часе. Расчёт основан на стандартном определении часа как 60 минут.

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

public int toSecondsPart()

Извлекает секундную часть длительности.

Возвращает количество оставшихся секунд после деления toSeconds() на количество секунд в минуте. Расчёт основан на стандартном определении минуты как 60 секунд.

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

public int toMillisPart()

Извлекает миллисекундную часть длительности.

Возвращает миллисекундную часть, деля количество наносекунд на 1 000 000. Длительность хранится в двух полях — секундах и наносекундах. Часть в наносекундах — это значение от 0 до 999 999 999, корректирующее длительность в секундах. Общая длительность определяется вызовом getNano() и getSeconds().

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

public int toNanosPart()

Возвращает часть длительности в наносекундах внутри секунд.

Длительность хранится в двух полях — секундах и наносекундах. Часть в наносекундах — это значение от 0 до 999 999 999, корректирующее длительность в секундах. Общая длительность определяется вызовом getNano() и getSeconds().

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

public Duration truncatedTo(TemporalUnit unit)

Возвращает копию этой Duration, усечённую до указанной единицы измерения.

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

Длительность, соответствующая единице измерения, должна делить продолжительность стандартного дня без остатка. Это условие выполняется для всех единиц измерения времени из ChronoUnit и для DAYS. Для других ChronoUnits выбрасывается исключение.

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

public int compareTo(Duration otherDuration)

Сравнивает эту длительность с указанной Duration.

Сравнение основано на общей продолжительности длительностей. Оно «согласуется с equals» согласно определению в Comparable.

public boolean equals(Object other)

Проверяет, равна ли эта длительность указанной Duration.

Сравнение основано на общей продолжительности длительностей.

public int hashCode()

Хеш-код этой длительности.

public String toString()

Строковое представление этой длительности в формате, основанном на секундах ISO-8601, например PT8H6M12.345S.

Возвращаемая строка имеет формат PTnHnMnS, где n — соответствующая часть длительности в часах, минутах или секундах. Дробная часть секунд указывается после десятичной точки в секции секунд. Секции с нулевым значением опускаются. Знак у часов, минут и секунд будет одинаковым.

Примеры:

   "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.