GetSystemTime 函式 (sysinfoapi.h)

發行項
03/05/2024

以國際標準時間 (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)
程式庫	Kernel32.lib
DLL	Kernel32.dll