Пакет kotlin.time
API для представления значений Duration и экспериментальный API для измерения временных интервалов.
Типы
AbstractDoubleTimeSource
Абстрактный класс, используемый для реализации источников времени, возвращающих свои показания как значения Double в указанной единице измерения.
abstract class AbstractDoubleTimeSource : TimeSource
AbstractLongTimeSource
Абстрактный класс, используемый для реализации источников времени, возвращающих свои показания как значения Long в указанной единице измерения.
abstract class AbstractLongTimeSource : TimeSource
Duration
Представляет количество времени, которое проходит между одним мгновением времени и другим.
class Duration : Comparable<Duration>
DurationUnit
Список возможных единиц измерения времени, в которых может быть выражена продолжительность.
enum class DurationUnit
TestTimeSource
Источник времени с программно изменяемыми показаниями. Он полезен как предсказуемый источник времени в тестах.
class TestTimeSource : AbstractLongTimeSource
TimedValue
Класс данных, представляющий результат выполнения действия вместе с продолжительностью интервала времени.
data class TimedValue<T>
TimeMark
Представляет временную метку, отмеченную на определённом TimeSource. Остаётся связанной с источником времени, из которого была взята, и позволяет запрашивать продолжительность времени, прошедшего с этой точки (см. функцию elapsedNow).
interface TimeMark
TimeSource
Источник времени для измерения временных интервалов.
interface TimeSource
Аннотации
ExperimentalTime
Эта аннотация отмечает экспериментальный предварительный просмотр API стандартной библиотеки для измерения времени и работы с продолжительностями.
annotation class ExperimentalTime
Расширения для внешних классов
java.time.Duration
java.util.concurrent.TimeUnit
Свойства
days
hours
микросекунды
Возвращает Duration, равный этому числу микросекунд, выраженному в Int.
val Int.microseconds: Duration
миллисекунды
Возвращает Duration, равный этому числу миллисекунд, выраженному в Int.
val Int.milliseconds: Duration
минуты
наносекунды
Возвращает Duration, равный этому числу наносекунд, выраженному в Int.
val Int.nanoseconds: Duration
секунды
Функции
compareTo
operator fun TimeMark.compareTo(other: TimeMark): Int
measureTime
Выполняет заданную функцию block и возвращает продолжительность интервала времени.
fun measureTime(block: () -> Unit): Duration
fun TimeSource.measureTime(block: () -> Unit): Duration
fun Monotonic.measureTime(block: () -> Unit): Duration
measureTimedValue
Выполняет заданную функцию 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>
minus
operator fun TimeMark.minus(other: TimeMark): Duration
times
Возвращает продолжительность, значение которой равно указанному значению duration, умноженному на это число.
operator fun Int.times(duration: Duration): Duration
operator fun Double.times(duration: Duration): Duration
toDuration
Возвращает Duration, равную этому числу Int в указанных единицах.
fun Int.toDuration(unit: DurationUnit): Duration
toJavaDuration
Преобразует значение kotlin.time.Duration в значение java.time.Duration.
fun Duration.toJavaDuration(): Duration
toTimeUnit
Преобразует значение перечисления kotlin.time.DurationUnit в соответствующее значение java.util.concurrent.TimeUnit.
fun DurationUnit.toTimeUnit(): TimeUnit
© 2010–2022 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/index.html