Spec-Zone.ru › Kotlin 1.8

Пакет kotlin.time

kotlin-stdlib / kotlin.time

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

Типы

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

AbstractDoubleTimeSource

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

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

AbstractLongTimeSource

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

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

ComparableTimeMark

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

interface ComparableTimeMark : 
    TimeMark, 
    Comparable<ComparableTimeMark>
Требования к платформе и версии: 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.8)

java.util.concurrent.TimeUnit

Свойства

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

дни

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

val Int.days: Duration

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

val Long.days: Duration

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

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

часов

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

val Int.hours: Duration

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

val Long.hours: Duration

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

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

микросекунд

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

val Int.microseconds: Duration

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

val Long.microseconds: Duration

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

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

миллисекунд

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

val Int.milliseconds: Duration

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

val Long.milliseconds: Duration

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

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

минут

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

val Int.minutes: Duration

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

val Long.minutes: Duration

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

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

наносекунд

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

val Int.nanoseconds: Duration

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

val Long.nanoseconds: Duration

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

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

секунд

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

val Int.seconds: Duration

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

val Long.seconds: Duration

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

val Double.seconds: Duration

Функции

Требования к платформе и версии: 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.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.8)

toTimeUnit

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

fun DurationUnit.toTimeUnit(): TimeUnit

© 2010–2023 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