通过

timeGetTime 函数 (timeapi.h)

  • 项目

timeGetTime 函数检索系统时间（以毫秒为单位）。 系统时间是 Windows 启动以来经过的时间。

语法

DWORD timeGetTime();

返回值

返回系统时间（以毫秒为单位）。

注解

此函数与 timeGetSystemTime 函数之间的唯一区别是 timeGetSystemTime 使用 MMTIME 结构返回系统时间。 timeGetTime 函数的开销小于 timeGetSystemTime。

请注意， timeGetTime 函数返回的值是 DWORD 值。 返回值每隔 2^32 毫秒大约为 0，大约为 49.71 天。 这可能会导致在计算中直接使用 timeGetTime 返回值的代码出现问题，尤其是在值用于控制代码执行的情况下。 在计算中应始终使用两 个 timeGetTime 返回值之间的差异。

timeGetTime 函数的默认精度可以是 5 毫秒或更多，具体取决于计算机。 可以使用 timeBeginPeriod 和 timeEndPeriod 函数来提高 timeGetTime 的精度。 如果这样做， timeGetTime 返回的连续值之间的最小差值可以与使用 timeBeginPeriod 和 timeEndPeriod 设置的最小时间段值一样大。 使用 QueryPerformanceCounter 和 QueryPerformanceFrequency 函数以高分辨率测量短时间间隔。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 timeapi.h (包括 Windows.h)
Library Winmm.lib
DLL Winmm.dll

另请参阅

多媒体计时器函数

多媒体计时器