# time-benchmark

**Repository Path**: AELOONG/time-benchmark

## Basic Information

- **Project Name**: time-benchmark
- **Description**: 各种时间函数基准测试
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-19
- **Last Updated**: 2024-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 各种时间函数基准测试
### 函数
#### C/C++
|**函数**|**注解**|
|:----|:----|
|`std::chrono::system_clock`	|
|`std::chrono::steady_clock`	|
|`std::chrono::high_resolution_clock`	|**[通常它只是 `std::chrono::steady_clock` 或 `std::chrono::system_clock` 的别名，但具体是哪个取决于库或配置。它是 `system_clock` 时不是单调的（即时间能后退）。例如：如 2023 年所知，libstdc++ 中它是 `system_clock` 的别名“直到高于纳秒的定义变得可行”，MSVC 中它是 `steady_clock` 的别名，而 libc++ 中当 C++ 标准库实现支持单调时钟时为 `steady_clock`，否则为 `system_clock` 的别名。](https://en.cppreference.com/w/cpp/chrono/high_resolution_clock#Notes)**|
|`std::chrono::utc_clock`	|
|`std::chrono::tai_clock`	|
|`std::chrono::gps_clock`	|
|`time`	|
|`clock`	|

#### Windows
<table>
    <tr>
        <td><a href="https://learn.microsoft.com/zh-cn/windows/win32/sysinfo/time-functions">函数</a></td>
        <td>介绍</td>
        <td colspan="2">注解</td>
        <td>声明</td>
        <td>用法</td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/sysinfoapi/nf-sysinfoapi-gettickcount"> GetTickCount </a></code>
        </td>
        <td rowspan="2">检索自系统启动以来经过的毫秒数。</td>
        <td><code>GetTickCount</code>最长为 49.7 天</td>
        <td rowspan="2"><code>GetTickCount(64)</code> 函数的分辨率限制为系统计时器的分辨率，通常介于 10 毫秒到 16 毫秒之间。<br><code>GetTickCount(64)</code> 函数的分辨率不受 <code>GetSystemTimeAdjustment</code> 函数所做的调整的影响。</td>
        <td>
            <pre>DWORD GetTickCount();</pre>
        </td>
        <td></td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/sysinfoapi/nf-sysinfoapi-gettickcount64">GetTickCount64</a></code>
        </td>
        <td></td>
        <td>
            <pre>ULONGLONG GetTickCount64();</pre>
        </td>
        <td></td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/sysinfoapi/nf-sysinfoapi-getlocaltime">GetLocalTime</a></code>
        </td>
        <td>检索当前本地日期和时间。</td>
        <td colspan="2"></td>
        <td>
            <pre>void GetLocalTime(<br>&nbsp; [out] LPSYSTEMTIME lpSystemTime<br>);</pre>
        </td>
        <td rowspan="2"><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/sysinfoapi/nf-sysinfoapi-getsystemtime#examples">example</a>
        </td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/sysinfoapi/nf-sysinfoapi-getsystemtime">GetSystemTime</a></code>
        </td>
        <td>检索协调世界时 (UTC) 格式的当前系统日期和时间。</td>
        <td colspan="2"></td>
        <td>
            <pre>void GetSystemTime(<br>&nbsp; [out] LPSYSTEMTIME lpSystemTime<br>);</pre>
        </td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/sysinfoapi/nf-sysinfoapi-getsystemtimepreciseasfiletime?redirectedfrom=MSDN">GetSystemTimePreciseAsFileTime</a></code>
        </td>
        <td><code>GetSystemTimePreciseAsFileTime</code> 函数以最高精度 (<1us) 检索当前系统日期和时间。 检索到的信息采用协调世界时 (UTC) 格式。</td>
        <td colspan="2"></td>
        <td>
            <pre>void GetSystemTimePreciseAsFileTime(<br>&nbsp; [out] LPFILETIME lpSystemTimeAsFileTime<br>);</pre>
        </td>
        <td></td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/processthreadsapi/nf-processthreadsapi-getsystemtimes">GetSystemTimes</a></code>
        </td>
        <td>检索系统计时信息。 在多处理器系统上，返回的值是所有处理器中指定时间的总和。</td>
        <td colspan="2"></td>
        <td>
            <pre>BOOL GetSystemTimes(<br>&nbsp; [out, optional] PFILETIME lpIdleTime,<br>&nbsp; [out, optional] PFILETIME lpKernelTime,<br>&nbsp; [out, optional] PFILETIME lpUserTime<br>);</pre>
        </td>
        <td></td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/profileapi/nf-profileapi-queryperformancecounter">QueryPerformanceCounter</a></code>
        </td>
        <td>检索性能计数器的当前值，这是一个高分辨率 (&lt;1us) 时间戳，可用于时间间隔度量。</td>
        <td colspan="2"></td>
        <td>
            <pre>BOOL QueryPerformanceCounter(<br>&nbsp; [out] LARGE_INTEGER *lpPerformanceCount<br>);</pre>
        </td>
        <td><a href="https://learn.microsoft.com/zh-cn/windows/win32/sysinfo/acquiring-high-resolution-time-stamps#using-qpc-in-native-code">example</a>
        </td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryinterrupttime">QueryInterruptTime</a></code>
        </td>
        <td>获取当前的中断时间计数</td>
        <td colspan="2"><code>timeBeginPeriod</code> 和 <code>timeEndPeriod</code> 函数设置的计时器分辨率会影响 <code>queryInterruptTime</code> 函数的 分辨率。</td>
        <td>
            <pre>void QueryInterruptTime(<br>&nbsp; [out] PULONGLONG lpInterruptTime<br>);</pre>
        </td>
        <td rowspan="4"><a href="https://learn.microsoft.com/zh-cn/windows/win32/sysinfo/interrupt-time">example</a>
        </td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryinterrupttimeprecise">QueryInterruptTimePrecise</a></code>
        </td>
        <td>获取当前中断时间计数，其格式比 <code>queryInterruptTime</code> 更精确 。</td>
        <td colspan="2"></td>
        <td>
            <pre>void QueryInterruptTimePrecise(<br>&nbsp; [out] PULONGLONG lpInterruptTimePrecise<br>);</pre>
        </td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryunbiasedinterrupttime">QueryUnbiasedInterruptTime</a></code>
        </td>
        <td>获取以 100 纳秒为单位的当前无偏中断时间计数。 无偏见的中断时间计数不包括系统在睡眠或休眠中花费的时间。</td>
        <td colspan="2"><code>timeBeginPeriod</code> 和 <code>timeEndPeriod</code> 函数设置的计时器分辨率会影响 <code>queryInterruptTime</code> 函数的 分辨率。</td>
        <td>
            <pre>BOOL QueryUnbiasedInterruptTime(<br>&nbsp; PULONGLONG UnbiasedTime<br>);</pre>
        </td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryunbiasedinterrupttimeprecise">QueryUnbiasedInterruptTimePrecise</a></code>
        </td>
        <td>获取与 <code>queryUnbiasedInterruptTime</code> 相比 ，以更精确的形式获取当前的无偏中断时间计数。 无偏见的中断时间计数不包括系统在睡眠或休眠中花费的时间。</td>
        <td colspan="2"></td>
        <td>
            <pre>void QueryUnbiasedInterruptTimePrecise(<br>&nbsp; [out] PULONGLONG lpUnbiasedInterruptTimePrecise<br>);</pre>
        </td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/timeapi/nf-timeapi-timegettime">timeGetTime</a></code>
        </td>
        <td><code>timeGetTime</code> 函数检索系统时间（以毫秒为单位）。 系统时间是 Windows 启动以来经过的时间。</td>
        <td colspan="2"><code>timeGetTime</code> 函数的默认精度可以是 5 毫秒或更多</td>
        <td>
            <pre>DWORD timeGetTime();</pre>
        </td>
        <td></td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/cpp/intrinsics/rdtsc?view=msvc-170">rdtsc</a></code></td>
        <td>该指令将返回处理器时间戳。 处理器时间戳记录自上次重置以来的时钟周期数。</td>
        <td colspan="2"><a href="https://learn.microsoft.com/zh-cn/windows/win32/sysinfo/acquiring-high-resolution-time-stamps#direct-tsc-usage">在某些版本的 Windows 上、虚拟机的实时迁移以及没有固定或紧密同步 TSC 的硬件系统上，你不会获得可靠的结果。</a></td>
        <td>
            <pre>unsigned __int64 __rdtsc();</pre>
        </td>
        <td><a href="https://learn.microsoft.com/zh-cn/cpp/intrinsics/rdtsc?view=msvc-170#example">example</a>
        </td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/processthreadsapi/nf-processthreadsapi-getthreadtimes">GetThreadTimes</a></code>
        </td>
        <td>检索指定线程的计时信息。</td>
        <td colspan="2"></td>
        <td>
            <pre>BOOL GetThreadTimes(<br>&nbsp; [in]&nbsp; HANDLE&nbsp;&nbsp;&nbsp;&nbsp; hThread,<br>&nbsp; [out] LPFILETIME lpCreationTime,<br>&nbsp; [out] LPFILETIME lpExitTime,<br>&nbsp; [out] LPFILETIME lpKernelTime,<br>&nbsp; [out] LPFILETIME lpUserTime<br>);</pre>
        </td>
        <td></td>
    </tr>
    <tr>
        <td><code><a href="https://learn.microsoft.com/zh-cn/windows/win32/api/processthreadsapi/nf-processthreadsapi-getprocesstimes">GetProcessTimes</a></code>
        </td>
        <td>检索指定进程的计时信息。</td>
        <td colspan="2"></td>
        <td>
            <pre>BOOL GetProcessTimes(<br>&nbsp; [in]&nbsp; HANDLE&nbsp;&nbsp;&nbsp;&nbsp; hProcess,<br>&nbsp; [out] LPFILETIME lpCreationTime,<br>&nbsp; [out] LPFILETIME lpExitTime,<br>&nbsp; [out] LPFILETIME lpKernelTime,<br>&nbsp; [out] LPFILETIME lpUserTime<br>);</pre>
        </td>
        <td></td>
    </tr>
</table>


##### Note
> [Query[Unbiased]InterruptTime](https://learn.microsoft.com/zh-cn/windows/win32/sysinfo/interrupt-time) 例程链接OneCore.lib 库, 这在MSVC, ClangCL是有效的, 但在MinGW-w64无法找到OneCore.lib。
>
> 而链接[QueryInterruptTime[Precise]](https://learn.microsoft.com/zh-cn/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryinterrupttime#requirements)等中断函数的介绍页的要求的Mincore.lib是可以正常使用的。
>
> [QueryUnbiasedInterruptTime[Precise]](https://learn.microsoft.com/zh-cn/windows/win32/api/realtimeapiset/nf-realtimeapiset-queryinterrupttimeprecise)虽然没有要求额外的库，但实践中仍然需要链接OneCore.lib/Mincore.lib。