minus

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

fun minus(duration: Duration): ValueTimeMark

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

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

Если метка времени корректируется слишком далеко в прошлое или будущее, она может насытиться до бесконечно отдалённой метки времени. В этом случае elapsedNow вернёт бесконечную продолжительность, прошедшую с такой бесконечно отдалённой метки.

Исключения

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

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

fun minus(other: ComparableTimeMark): Duration

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

Возвращаемая продолжительность может быть бесконечной, если метки времени находятся далеко друг от друга и результат не помещается в тип Duration, или если одна метка времени бесконечно отдалённа, или если обе this и other метки времени лежат бесконечно далеко на противоположных сторонах шкалы времени.

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

Обратите внимание, что другая метка времени должна быть получена из того же источника времени, что и эта.

Исключения

IllegalArgumentException — если метки времени были получены из разных источников времени.

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

operator fun minus(other: ValueTimeMark): Duration

Возвращает продолжительность, прошедшую между меткой времени other, полученной из того же источника времени TimeSource.Monotonic, и this меткой времени.

Возвращаемая продолжительность может быть бесконечной, если метки времени находятся далеко друг от друга и результат не помещается в тип Duration, или если одна метка времени бесконечно отдалённа, или если обе this и other метки времени лежат бесконечно далеко на противоположных сторонах шкалы времени.

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