Класс Duration

ZERO

public static final Duration ZERO

ofDays

public static Duration ofDays(long days)

Параметры:

days - количество дней, положительное или отрицательное

Возвращает:

значение Duration, не null

Изволяет:

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

ofHours

public static Duration ofHours(long hours)

Параметры:

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

Возвращает:

значение Duration, не null

Изволяет:

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

ofMinutes

public static Duration ofMinutes(long minutes)

Параметры:

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

Возвращает:

значение Duration, не null

Изволяет:

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

ofSeconds

public static Duration ofSeconds(long seconds)

Параметры:

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

Возвращает:

значение Duration, не null

ofSeconds

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

ofMillis

public static Duration ofMillis(long millis)

Параметры:

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

Возвращает:

значение Duration, не null

ofNanos

public static Duration ofNanos(long nanos)

Параметры:

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

Возвращает:

значение Duration, не null

of

public static Duration of(long amount, TemporalUnit unit)

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

Параметры:

amount - количество длительности, измеренное в терминах единицы, положительное или отрицательное

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

Возвращает:

значение Duration, не null

Изволяет:

DateTimeException - если единица периода имеет оценённую длительность

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

from

public static Duration from(TemporalAmount amount)

Параметры:

amount - временное количество для преобразования, не null

Возвращает:

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

Изволяет:

DateTimeException - если невозможно преобразовать во Duration

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

parse

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

Параметры:

text - текст для разбора, не null

Возвращает:

разбор длительности, не null

Изволяет:

DateTimeParseException - если текст не может быть преобразован в длительность

between

public static Duration between(Temporal startInclusive, Temporal endExclusive)

Параметры:

startInclusive - начальная точка, включая, не null

endExclusive - конечная точка, исключая, не null

Возвращает:

значение Duration, не null

Изволяет:

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

ArithmeticException - если вычисление превышает емкость Duration

get

public long get(TemporalUnit unit)

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

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

Параметры:

unit - TemporalUnit для которого вернуть значение

Возвращает:

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

Изволяет:

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

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

getUnits

public List<TemporalUnit> getUnits()

Specified by:

getUnits in interface TemporalAmount

Returns:

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

isZero

public boolean isZero()

Returns:

true, если эта продолжительность имеет полную длину, равную нулю

isNegative

public boolean isNegative()

Returns:

true, если эта продолжительность имеет общую длину меньше нуля

getSeconds

public long getSeconds()

Returns:

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

getNano

public int getNano()

Returns:

наносекунды в части секунд длины продолжительности, от 0 до 999 999 999

withSeconds

public Duration withSeconds(long seconds)

Parameters:

seconds - секунды для представления, могут быть отрицательными

Returns:

Duration на основе этого периода со значениями запрошенных секунд, не null

withNanos

public Duration withNanos(int nanoOfSecond)

Parameters:

nanoOfSecond - наносекунды для представления, от 0 до 999 999 999

Returns:

Duration на основе этого периода со значениями запрошенных наносекунд, не null

Throws:

DateTimeException - если наносекунды недействительны

plus

public Duration plus(Duration duration)

Parameters:

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

Returns:

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

Throws:

ArithmeticException - если произошел переполнение численного типа

plus

public Duration plus(long amountToAdd, TemporalUnit unit)

Parameters:

amountToAdd - количество для добавления, измеренное в терминах единицы, положительное или отрицательное

unit - единица измерения количества, должна иметь точную продолжительность, не null

Returns:

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

Throws:

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

ArithmeticException - если произошел переполнение численного типа

plusDays

public Duration plusDays(long daysToAdd)

Parameters:

daysToAdd - дни для добавления, положительные или отрицательные

Returns:

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

Throws:

ArithmeticException - если произошел переполнение численного типа

plusHours

public Duration plusHours(long hoursToAdd)

Parameters:

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

Returns:

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

Throws:

ArithmeticException - если произошел переполнение численного типа

plusMinutes

public Duration plusMinutes(long minutesToAdd)

Parameters:

minutesToAdd - минуты для добавления, положительные или отрицательные

Returns:

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

Throws:

ArithmeticException - если произошел переполнение численного типа

plusSeconds

public Duration plusSeconds(long secondsToAdd)

Parameters:

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

Returns:

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

Throws:

ArithmeticException - если произошел переполнение численного типа

plusMillis

public Duration plusMillis(long millisToAdd)

Parameters:

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

Returns:

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

Throws:

ArithmeticException - если произошел переполнение численного типа

plusNanos

public Duration plusNanos(long nanosToAdd)

Parameters:

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

Returns:

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

Throws:

ArithmeticException - если произошел переполнение численного типа

minus

public Duration minus(Duration duration)

Parameters:

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

Returns:

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

Throws:

ArithmeticException - если произошел переполнение численного типа

minus

public Duration minus(long amountToSubtract, TemporalUnit unit)

Параметры:

amountToSubtract - величина для вычитания, измеренная в единицах, положительная или отрицательная

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

Возвращает:

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

Исключения:

ArithmeticException - если происходит арифметическое переполнение

minusDays

public Duration minusDays(long daysToSubtract)

Параметры:

daysToSubtract - дни для вычитания, положительные или отрицательные

Возвращает:

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

Исключения:

ArithmeticException - если происходит арифметическое переполнение

minusHours

public Duration minusHours(long hoursToSubtract)

Параметры:

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

Возвращает:

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

Исключения:

ArithmeticException - если происходит арифметическое переполнение

minusMinutes

public Duration minusMinutes(long minutesToSubtract)

Параметры:

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

Возвращает:

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

Исключения:

ArithmeticException - если происходит арифметическое переполнение

minusSeconds

public Duration minusSeconds(long secondsToSubtract)

Параметры:

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

Возвращает:

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

Исключения:

ArithmeticException - если происходит арифметическое переполнение

minusMillis

public Duration minusMillis(long millisToSubtract)

Параметры:

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

Возвращает:

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

Исключения:

ArithmeticException - если происходит арифметическое переполнение

minusNanos

public Duration minusNanos(long nanosToSubtract)

Параметры:

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

Возвращает:

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

Исключения:

ArithmeticException - если происходит арифметическое переполнение

multipliedBy

public Duration multipliedBy(long multiplicand)

Параметры:

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

Возвращает:

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

Исключения:

ArithmeticException - если происходит арифметическое переполнение

dividedBy

public Duration dividedBy(long divisor)

Параметры:

divisor - значение, на которое нужно разделить продолжительность, положительное или отрицательное, не ноль

Возвращает:

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

Исключения:

ArithmeticException - если делитель равен нулю или происходит арифметическое переполнение

dividedBy

public long dividedBy(Duration divisor)

Параметры:

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

Возвращает:

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

Исключения:

ArithmeticException - если делитель равен нулю или происходит арифметическое переполнение

С версии:

9

negated

public Duration negated()

Возвращает:

a Duration на основе этой продолжительности с отрицательной величиной, не null

Исключения:

ArithmeticException - если происходит арифметическое переполнение

abs

public Duration abs()

Возвращает:

a Duration на основе этой продолжительности с абсолютной длиной, не null

Исключения:

ArithmeticException - если происходит арифметическое переполнение

addTo

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 - если происходит арифметическое переполнение

subtractFrom

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 - если происходит арифметическое переполнение

toDays

public long toDays()

Возвращает:

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

toHours

public long toHours()

Возвращает:

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

toMinutes

public long toMinutes()

Возвращает:

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

toSeconds

public long toSeconds()

Возвращает:

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

С тех пор как:

9

toMillis

public long toMillis()

Возвращает:

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

Исключения:

ArithmeticException - если происходит переполнение чисел

toNanos

public long toNanos()

Возвращает:

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

Исключения:

ArithmeticException - если происходит переполнение чисел

toDaysPart

public long toDaysPart()

Возвращает:

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

С тех пор как:

9

toHoursPart

public int toHoursPart()

Возвращает:

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

С тех пор как:

9

toMinutesPart

public int toMinutesPart()

Возвращает:

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

С тех пор как:

9

toSecondsPart

public int toSecondsPart()

Возвращает:

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

С тех пор как:

9

toMillisPart

public int toMillisPart()

Возвращает:

количество миллисекунд в интервале.

С тех пор как:

9

toNanosPart

public int toNanosPart()

Возвращает:

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

С тех пор как:

9

truncatedTo

public Duration truncatedTo(TemporalUnit unit)

Параметры:

unit - подразделение для усечения, не null

Возвращает:

копия Duration на основе этого интервала времени с усечённым временем, не null

Исключения:

DateTimeException - если подразделение недействительно для усечения

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

С тех пор как:

9

compareTo

public int compareTo(Duration otherDuration)

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

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

Параметры:

otherDuration - другой интервал времени для сравнения, не null

Возвращает:

значение компаратора, отрицательное, если меньше, положительное, если больше

equals

public boolean equals(Object other)

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

equals в классе Object

Параметры:

other - другой интервал времени, null возвращает false

Возвращает:

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

См. также:

• Object.hashCode()
• HashMap

hashCode

public int hashCode()

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

hashCode в классе Object

Возвращает:

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

См. также:

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

toString

public String toString()

    "20.345 seconds"                 -- "PT20.345S
    "15 minutes" (15 * 60 seconds)   -- "PT15M"
    "10 hours" (10 * 3600 seconds)   -- "PT10H"
    "2 days" (2 * 86400 seconds)     -- "PT48H"
 

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

toString в классе Object

Возвращает:

представление интервала времени в формате ISO-8601, не null