Пакет kotlin.time

Абстрактный класс, используемый для реализации источников времени, которые возвращают свои показания в виде значений Double в указанных единицах.

abstract class AbstractDoubleTimeSource : WithComparableMarks

Абстрактный класс, используемый для реализации источников времени, которые возвращают свои показания в виде значений Long в указанных единицах.

abstract class AbstractLongTimeSource : WithComparableMarks

TimeMark, который может быть сравнен на разницу с другими метками времени, полученными от одного и того же источника времени TimeSource.WithComparableMarks.

interface ComparableTimeMark : 
    TimeMark, 
    Comparable<ComparableTimeMark>

Представляет количество времени, которое отделяет одну точку времени от другой.

class Duration : Comparable<Duration>

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

enum class DurationUnit

Источник времени с программно изменяемыми показаниями. Полезен в качестве предсказуемого источника времени в тестах.

class TestTimeSource : AbstractLongTimeSource

Класс данных, представляющий результат выполнения действия вместе с длительностью прошедшего временного интервала.

data class TimedValue<T>

Представляет временную точку, отмеченную на определённом TimeSource. Остаётся связанной с источником времени, из которого была взята, и позволяет запросить длительность времени, прошедшего с этой точки (см. функцию elapsedNow).

interface TimeMark

Источник времени для измерения временных интервалов.

interface TimeSource

Эта аннотация отмечает экспериментальный предварительный просмотр API стандартной библиотеки для измерения времени и работы с продолжительностями.

annotation class ExperimentalTime

Возвращает Duration, равный этому числу целых дней.

val Int.days: Duration

Возвращает Duration, равный этому числу длинных дней.

val Long.days: Duration

Возвращает Duration, равный этому числу двойных дней.

val Double.days: Duration

Возвращает Duration, равный этому числу целых часов.

val Int.hours: Duration

Возвращает Duration, равный этому числу длинных часов.

val Long.hours: Duration

Возвращает Duration, равный этому числу двойных часов.

val Double.hours: Duration

Возвращает Duration, равный этому числу целых микросекунд.

val Int.microseconds: Duration

Возвращает Duration, равный этому числу длинных микросекунд.

val Long.microseconds: Duration

Возвращает Duration, равный этому числу двойных микросекунд.

val Double.microseconds: Duration

Возвращает Duration, равный этому числу целых миллисекунд.

val Int.milliseconds: Duration

Возвращает Duration, равный этому числу длинных миллисекунд.

val Long.milliseconds: Duration

Возвращает Duration, равный этому числу двойных миллисекунд.

val Double.milliseconds: Duration

Возвращает Duration, равный этому числу целых минут.

val Int.minutes: Duration

Возвращает Duration, равный этому числу длинных минут.

val Long.minutes: Duration

Возвращает Duration, равный этому числу двойных минут.

val Double.minutes: Duration

Возвращает Duration, равный этому числу целых наносекунд.

val Int.nanoseconds: Duration

Возвращает Duration, равный этому числу длинных наносекунд.

val Long.nanoseconds: Duration

Возвращает Duration, равный этому числу двойных наносекунд.

val Double.nanoseconds: Duration

Возвращает Duration, равный этому числу целых секунд.

val Int.seconds: Duration

Возвращает Duration, равный этому числу длинных секунд.

val Long.seconds: Duration

Возвращает Duration, равный этому числу двойных секунд.

val Double.seconds: Duration

Выполняет заданную функцию block и возвращает продолжительность интервала прошедшего времени.

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

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

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

Выполняет заданную функцию block и возвращает экземпляр класса TimedValue, содержащий как результат выполнения функции, так и продолжительность интервала прошедшего времени.

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

Выполняет заданный block и возвращает экземпляр класса TimedValue, содержащий как результат выполнения функции, так и продолжительность интервала прошедшего времени.

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

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

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

operator fun Int.times(duration: Duration): Duration

operator fun Double.times(duration: Duration): Duration

Возвращает Duration, равный этому числу Int указанной unit.

fun Int.toDuration(unit: DurationUnit): Duration

Возвращает Duration, равный этому числу Long указанной unit.

fun Long.toDuration(unit: DurationUnit): Duration

Возвращает Duration, равный этому числу Double указанной unit.

fun Double.toDuration(unit: DurationUnit): Duration

Преобразует значение kotlin.time.Duration в значение java.time.Duration.

fun Duration.toJavaDuration(): Duration

Преобразует это перечисление kotlin.time.DurationUnit в соответствующее значение java.util.concurrent.TimeUnit.

fun DurationUnit.toTimeUnit(): TimeUnit