Версия:

Модуль clock

Модуль clock

Общие сведения

Модуль clock возвращает значения времени, полученных из функции Posix / C CLOCK_GETTIME или аналогичной. Большинство функций модуля возвращают число секунд; функции, названия которых заканчиваются на «64», возвращают 64-разрадяное число наносекунд.

Индекс

Ниже приведен перечень всех функций модуля clock.

Имя Использование
clock.time()
clock.realtime()
Получение физического времени в секундах
clock.time64()
clock.realtime64()
Получение физического времени в наносекундах
clock.monotonic() Получение монотонного времени в секундах
clock.monotonic64() Получение монотонного времени в наносекундах
clock.proc() Получение времени процессора в секундах
clock.proc64() Получение времени процессора в наносекундах
clock.thread() Получение рабочего времени потока в секундах
clock.thread64() Получение рабочего времени потока в наносекундах
clock.bench() Измерение времени, которое функция проводит в процессоре
clock.time()
clock.time64()
clock.realtime()
clock.realtime64()

Физическое время в секундах. Получено из C-функции clock_gettime(CLOCK_REALTIME). Использование этой функции лучше всего подходит для выяснения официального времени, как установлено системным администратором.

возвращается:секунды или наносекунды с начала отсчета (1970-01-01 00:00:00), значение корректируется.
тип возвращаемого значения:
 число или 64-разрядное число

Пример:

-- Результатом будет примерное число лет с 1970.
  clock = require('clock')
  print(clock.time() / (365*24*60*60))

См. также fiber.time64 и стандартную Lua-функцию os.clock.

clock.monotonic()
clock.monotonic64()

Монотонное время. Получено из C-функции clock_gettime(CLOCK_MONOTONIC). Монотонное время похоже на физическое время, но на него не влияют изменения для перехода на летнее время или изменения, сделанные пользователем. Такую функцию лучше всего использовать для эталонного тестирования, где необходимо рассчитать затраченное время.

возвращается:секунды или наносекунды с момента последней загрузки компьютера.
тип возвращаемого значения:
 число или 64-разрядное число

Пример:

-- Результатом будет число наносекунд с запуска.
  clock = require('clock')
  print(clock.monotonic64())
clock.proc()
clock.proc64()

Время процессора. Получено из C-функции clock_gettime(CLOCK_PROCESS_CPUTIME_ID). Такую функцию лучше всего использовать для эталонного тестирования, где необходимо рассчитать время, затраченное на процессоре.

возвращается:секунды или наносекунды с момента начала работы процессора.
тип возвращаемого значения:
 число или 64-разрядное число

Пример:

-- Результатом будет число наносекунд с запуска процессора.
  clock = require('clock')
  print(clock.proc64())
clock.thread()
clock.thread64()

Рабочее время потока. Получено из C-функции clock_gettime(CLOCK_THREAD_CPUTIME_ID). Такую функцию лучше всего использовать для эталонного тестирования, где необходимо рассчитать время, затраченное потоком на процессоре.

возвращается:секунды или наносекунды с момента начала работы потока процессора транзакций.
тип возвращаемого значения:
 число или 64-разрядное число

Пример:

-- Результатом будет число секунд с момента начала работы потока.
  clock = require('clock')
  print(clock.thread64())
clock.bench(function[, ...])

Время, которое функция проводит в процессоре. Данная функция использует clock.proc(), то есть рассчитывает затраченное процессором время. Таким образом, она не используется для отображения фактически затраченного времени.

Параметры:
  • function (function) – функция или ссылка на функцию
  • ... – значения, которые необходимы для функции.
возвращается:

таблица. Первый элемент – время работы процессора в секундах, второй элемент – то, что возвращает функция.

Пример:

-- Эталонное тестирование функции, которая находится в спящем режиме в течение 10 секунд.
  -- NB: bench() не будет рассчитывать время сна.
  -- Поэтому вернется значение, которое будет {число менее 10, 88}.
  clock = require('clock')
  fiber = require('fiber')
  function f(param)
    fiber.sleep(param)
    return 88
  end
  clock.bench(f, 10)