std/monotimes

Модуль std/monotimes реализует монотонные временные метки. Монотонная временная метка представляет время, прошедшее с некоторой системной точки отсчёта. Монотонные временные метки гарантированно не убывают, что означает, что следующее гарантированно сработает:

Пример:

import std/monotimes
let a = getMonoTime()
let b = getMonoTime()
assert a <= b

Это не гарантируется для типа times.Time! Это означает, что тип MonoTime следует использовать при измерении временных интервалов с высокой точностью.

Однако, поскольку MonoTime представляет время, прошедшее с момента неизвестного начального момента, его нельзя преобразовать в читаемую человеком временную метку. Если это требуется, следует использовать тип times.Time.

Тип MonoTime хранит временную метку с разрешением в наносекунды, но обратите внимание, что фактическое поддерживаемое разрешение времени отличается для разных систем.

См. также

• модуль times

Импорты

times

Типы

MonoTime = object

Представляет монотонную временную метку. Source Edit

Процедуры

proc `$`(t: MonoTime): string {....raises: [], tags: [], forbids: [].}

Source Edit

proc `+`(a: MonoTime; b: Duration): MonoTime {....raises: [], tags: [], forbids: [].}

Увеличивает a на b. Source Edit

proc `-`(a, b: MonoTime): Duration {....raises: [], tags: [], forbids: [].}

Возвращает разницу между двумя временными метками MonoTime в виде Duration. Source Edit

proc `-`(a: MonoTime; b: Duration): MonoTime {....raises: [], tags: [], forbids: [].}

Уменьшает a на b. Source Edit

proc `<`(a, b: MonoTime): bool {....raises: [], tags: [], forbids: [].}

Возвращает true, если a произошло до b. Source Edit

proc `<=`(a, b: MonoTime): bool {....raises: [], tags: [], forbids: [].}

Возвращает true, если a произошло до b или если они произошли одновременно. Source Edit

proc `==`(a, b: MonoTime): bool {....raises: [], tags: [], forbids: [].}

Возвращает true, если a и b произошли одновременно. Source Edit

proc getMonoTime(): MonoTime {....tags: [TimeEffect], raises: [], forbids: [].}

Возвращает текущую временную метку MonoTime.

При компиляции с JS-бекендом и выполнении в браузере эта процедура вызывает window.performance.now(). См. MDN для получения дополнительной информации.

Source Edit

proc high(typ: typedesc[MonoTime]): MonoTime

Возвращает наибольшую представимую временную метку MonoTime. Source Edit

proc low(typ: typedesc[MonoTime]): MonoTime

Возвращает наименьшую представимую временную метку MonoTime. Source Edit

proc ticks(t: MonoTime): int64 {....raises: [], tags: [], forbids: [].}

Возвращает значение сырых тиков из MonoTime. Это значение всегда использует разрешение времени в наносекундах. Source Edit