An abstract class used to implement time sources that return their readings as Long values in the specified unit.

AbstractLongTimeSource(unit: DurationUnit)

The unit in which this time source's readings are expressed.

val unit: DurationUnit

Marks a point in time on this time source.

open fun markNow(): TimeMark

This protected method should be overridden to return the current reading of the time source expressed as a Long number in the unit specified by the unit property.

abstract fun read(): Long

Executes the given function block and returns the duration of elapsed time interval.

fun TimeSource.measureTime(block: () -> Unit): Duration

Executes the given block and returns an instance of TimedValue class, containing both the result of function execution and the duration of elapsed time interval.

fun <T> TimeSource.measureTimedValue(
    block: () -> T
): TimedValue<T>

A time source that has programmatically updatable readings. It is useful as a predictable source of time in tests.

class TestTimeSource : AbstractLongTimeSource