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.