Spec-Zone.ru › Kotlin 1.7

Пакет kotlin.time

kotlin-stdlib / kotlin.time

API для представления значений Duration и экспериментальный API для измерения временных интервалов.

Типы

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

AbstractDoubleTimeSource

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

abstract class AbstractDoubleTimeSource : TimeSource
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

AbstractLongTimeSource

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

abstract class AbstractLongTimeSource : TimeSource
Требования к платформе и версии: JVM (1.6), JS (1.6), Native (1.6)

Duration

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

class Duration : Comparable<Duration>
Требования к платформе и версии: JVM (1.6), JS (1.6), Native (1.6)

DurationUnit

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

enum class DurationUnit
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

TestTimeSource

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

class TestTimeSource : AbstractLongTimeSource
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

TimedValue

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

data class TimedValue<T>
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

TimeMark

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

interface TimeMark
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

TimeSource

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

interface TimeSource

Аннотации

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

ExperimentalTime

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

annotation class ExperimentalTime

Расширения для внешних классов

Требования к платформе и версии: JVM (1.6), JRE8 (1.6)

java.time.Duration

Требования к платформе и версии: JVM (1.6)

java.util.concurrent.TimeUnit

Свойства

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

days

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

val Int.days: Duration

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

val Long.days: Duration

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

val Double.days: Duration
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

hours

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

val Int.hours: Duration

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

val Long.hours: Duration

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

val Double.hours: Duration
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

микросекунды

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

val Int.microseconds: Duration

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

val Long.microseconds: Duration

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

val Double.microseconds: Duration
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

миллисекунды

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

val Int.milliseconds: Duration

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

val Long.milliseconds: Duration

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

val Double.milliseconds: Duration
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

минуты

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

val Int.minutes: Duration

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

val Long.minutes: Duration

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

val Double.minutes: Duration
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

наносекунды

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

val Int.nanoseconds: Duration

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

val Long.nanoseconds: Duration

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

val Double.nanoseconds: Duration
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

секунды

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

val Int.seconds: Duration

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

val Long.seconds: Duration

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

val Double.seconds: Duration

Функции

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

compareTo

operator fun TimeMark.compareTo(other: TimeMark): Int
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

measureTime

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

fun measureTime(block: () -> Unit): Duration
fun TimeSource.measureTime(block: () -> Unit): Duration
fun Monotonic.measureTime(block: () -> Unit): Duration
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

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>
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

minus

operator fun TimeMark.minus(other: TimeMark): Duration
Требования к платформе и версии: JVM (1.6), JS (1.6), Native (1.6)

times

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

operator fun Int.times(duration: Duration): Duration
operator fun Double.times(duration: Duration): Duration
Требования к платформе и версии: JVM (1.6), JS (1.6), Native (1.6)

toDuration

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

fun Int.toDuration(unit: DurationUnit): Duration

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

fun Long.toDuration(unit: DurationUnit): Duration

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

fun Double.toDuration(unit: DurationUnit): Duration
Требования к платформе и версии: JVM (1.6), JRE8 (1.6)

toJavaDuration

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

fun Duration.toJavaDuration(): Duration
Требования к платформе и версии: JVM (1.6)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API