Duration

A duration of time at nanosecond precision.

For many applications, working with specific units like IntHours or LongSeconds is more efficient and plenty adequate. However, when working with larger durations at sub-second precision, overflow is a very real possibility. Duration is capable of representing fixed, nanosecond-precision durations that span the entire supported time scale, making it more suitable for these use cases.

Types

Companion

common

object Companion

Functions

compareTo

common

open operator override fun compareTo(other: Duration): Int

div

common

operator fun div(scalar: Int): Duration

Divides this duration by a scalar value.

equals

common

open operator override fun equals(other: Any?): Boolean

hashCode

common

open override fun hashCode(): Int

isNegative

common

fun isNegative(): Boolean

Checks if this duration is negative.

isPositive

common

fun isPositive(): Boolean

Checks if this duration is positive.

isZero

common

fun isZero(): Boolean

Checks if this duration is zero.

minus

common

operator fun minus(other: Duration): Duration

operator fun minus(days: IntDays): Duration

operator fun minus(hours: IntHours): Duration

operator fun minus(microseconds: IntMicroseconds): Duration

operator fun minus(milliseconds: IntMilliseconds): Duration

operator fun minus(minutes: IntMinutes): Duration

operator fun minus(nanoseconds: IntNanoseconds): Duration

operator fun minus(seconds: IntSeconds): Duration

operator fun minus(days: LongDays): Duration

operator fun minus(hours: LongHours): Duration

operator fun minus(microseconds: LongMicroseconds): Duration

operator fun minus(milliseconds: LongMilliseconds): Duration

operator fun minus(minutes: LongMinutes): Duration

operator fun minus(nanoseconds: LongNanoseconds): Duration

operator fun minus(seconds: LongSeconds): Duration

plus

common

operator fun plus(other: Duration): Duration

operator fun plus(days: IntDays): Duration

operator fun plus(hours: IntHours): Duration

operator fun plus(microseconds: IntMicroseconds): Duration

operator fun plus(milliseconds: IntMilliseconds): Duration

operator fun plus(minutes: IntMinutes): Duration

operator fun plus(nanoseconds: IntNanoseconds): Duration

operator fun plus(seconds: IntSeconds): Duration

operator fun plus(days: LongDays): Duration

operator fun plus(hours: LongHours): Duration

operator fun plus(microseconds: LongMicroseconds): Duration

operator fun plus(milliseconds: LongMilliseconds): Duration

operator fun plus(minutes: LongMinutes): Duration

operator fun plus(nanoseconds: LongNanoseconds): Duration

operator fun plus(seconds: LongSeconds): Duration

times

common

operator fun times(scalar: Int): Duration

Multiples this duration by a scalar value.

toComponents

common

inline fun <T> toComponents(action: (seconds: LongSeconds, nanoseconds: IntNanoseconds) -> T): T

Breaks this duration down into individual unit components.

inline fun <T> toComponents(action: (minutes: LongMinutes, seconds: IntSeconds, nanoseconds: IntNanoseconds) -> T): T

Breaks this duration down into individual unit components.

inline fun <T> toComponents(action: (hours: LongHours, minutes: IntMinutes, seconds: IntSeconds, nanoseconds: IntNanoseconds) -> T): T

Breaks this duration down into individual unit components.

inline fun <T> toComponents(action: (days: LongDays, hours: IntHours, minutes: IntMinutes, seconds: IntSeconds, nanoseconds: IntNanoseconds) -> T): T

Breaks this duration down into individual unit components, assuming a 24-hour day length.

toKotlinDuration

common

@ExperimentalTime()

fun toKotlinDuration(): Duration

Converts this duration to a kotlin.time.Duration.

toString

common

open override fun toString(): String

truncatedTo

common

fun truncatedTo(unit: TimeUnit): Duration

Returns this duration, rounded down to match the precision of a given unit.

unaryMinus

common

operator fun unaryMinus(): Duration

Properties

absoluteValue

common

val absoluteValue: Duration

The absolute value of this duration.

inDays

common

val inDays: LongDays

Converts this duration into the number of 24-hour days represented by it.

inHours

common

val inHours: LongHours

Converts this duration into the number of whole hours represented by it.

inMicroseconds

common

val inMicroseconds: LongMicroseconds

Converts this duration into the number of whole microseconds represented by it.

inMilliseconds

common

val inMilliseconds: LongMilliseconds

Converts this duration into the number of whole milliseconds represented by it.

inMinutes

common

val inMinutes: LongMinutes

Converts this duration into the number of whole minutes represented by it.

inNanoseconds

common

val inNanoseconds: LongNanoseconds

Converts this duration into LongNanoseconds.

inSeconds

common

val inSeconds: LongSeconds

Returns the number of whole seconds in this duration.

nanosecondAdjustment

common

val nanosecondAdjustment: IntNanoseconds

seconds

common

val seconds: LongSeconds

Extensions

toJavaDuration

jvm

fun Duration.toJavaDuration(): Duration

Converts this duration to an equivalent Java Duration.

toNSTimeInterval

darwin

fun Duration.toNSTimeInterval(): <ERROR CLASS>

Converts this duration to an equivalent NSTimeInterval.