GetSystemTime 函数 (sysinfoapi.h)

检索协调世界时 (UTC) 格式的当前系统日期和时间。

若要以本地时间检索当前系统日期和时间,请使用 GetLocalTime 函数。

语法

void GetSystemTime(
  [out] LPSYSTEMTIME lpSystemTime
);

参数

[out] lpSystemTime

指向 SYSTEMTIME 结构的指针,用于接收当前系统日期和时间。 lpSystemTime 参数不得为 NULL。 使用 NULL 将导致访问冲突。

返回值

备注

若要设置当前系统日期和时间,请使用 SetSystemTime 函数。

示例

#include <windows.h>
#include <stdio.h>

void main()
{
    SYSTEMTIME st, lt;
    
    GetSystemTime(&st);
    GetLocalTime(&lt);
    
    printf("The system time is: %02d:%02d\n", st.wHour, st.wMinute);
    printf(" The local time is: %02d:%02d\n", lt.wHour, lt.wMinute);
}
// Sample output

The system time is: 19:34
 The local time is: 12:34

有关此示例的详细信息,请参阅 SYSTEMTIME

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 sysinfoapi.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

GetLocalTime

GetSystemTimeAdjustment

GetSystemTimeAsFileTime

SYSTEMTIME

SetSystemTime

系统时间

时间函数