Skip to content

zariiii9003/win-precise-time

Repository files navigation

win-precise-time

PyPI - Version PyPI - Python Version Documentation Status

The documentation is available here.


Table of Contents

Description

On Windows the builtin time.time() provides a timestamp with ~15ms resolution. This package provides the function win_precise_time.time() to retrieve an accurate timestamp by using GetSystemTimePreciseAsFileTime. The function is implemented as a C extension so the performance is equal to the builtin time.perf_counter() (both functions rely on QueryPerformanceCounter).

The function win_precise_time.sleep() reimplements the more precise time.sleep() version of CPython >= 3.11 for older python versions. This enables sub-millisecond sleep precision without increasing the Windows timer resolution via timeBeginPeriod.

Installation

pip install win-precise-time

Usage

>>> import win_precise_time as wpt
>>> wpt.time()  # retrieve current time
1654539449.4548845
>>> wpt.sleep(0.001)  # sleep for 1ms

Test

pip install tox
tox

Build

pip install build
python -m build .

License

win-precise-time is distributed under the terms of the MIT license.