timeutil

High-performance C-backed Lua module for precision wall-clock time, monotonic time, and sleep utilities.

Check out the documentation for guides and examples.

✨ Features

• Monotonic Clock: Measure precise intervals unaffected by system clock shifts or NTP syncs.
• Wall-Clock Time: Fetch system real-time with sub-microsecond precision.
• Fractional Sleep: Sleep for fractional seconds without busy-waiting or high CPU utilization.
• Multiple Lua Versions: Compatible with LuaJIT, Lua 5.1, 5.2, 5.3, 5.4, and 5.5.
• Cross-Platform: Works consistently across Windows, macOS, and Linux.

📦 Installation

luarocks install timeutil

🚀 Usage

local timeutil = require "timeutil"

-- Measure precise elapsed time
local start = timeutil.mono()
timeutil.sleep(0.05) -- sleep for 50ms
local elapsed = timeutil.mono() - start

print(string.format("Elapsed:%.6f seconds", elapsed))
print(string.format("Current Unix timestamp: %.6f", timeutil.now()))