GetTimeZoneInformation 函式 (timezoneapi.h)

擷取目前的時區設定。這些設定可控制國際標準時間 (UTC) 和當地時間之間的翻譯。

若要支援從年份變更為年份的日光節約時間界限，請使用 GetDynamicTimeZoneInformation 或 GetTimeZoneInformationForYear 函式。

語法

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

[out] lpTimeZoneInformation

要接收目前設定之 TIME_ZONE_INFORMATION 結構的指標。

如果函式成功，它會傳回下列其中一個值。

傳回碼/值	Description
TIME_ZONE_ID_UNKNOWN 0	日光節約時間不會用於目前的時區，因為不會停用日光節約時間的轉換日期或自動調整。
TIME_ZONE_ID_STANDARD 1	系統會在 TIME_ZONE_INFORMATION 結構的 StandardDate 成員所涵蓋的範圍中運作。
TIME_ZONE_ID_DAYLIGHT 2	系統會在TIME_ZONE_INFORMATION 結構之 DaylightDate 成員涵蓋的範圍中運作。

如果函式因其他原因而失敗，例如記憶體不足錯誤，則會傳回TIME_ZONE_ID_INVALID。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

UTC 時間與當地時間之間的所有翻譯都是以下列公式為基礎：

UTC = 當地時間 + 偏差

偏差是UTC時間與當地時間之間的差異，以分鐘為單位。

結果TIME_ZONE_INFORMATION結構的 StandardName 和 DaylightName 成員會根據目前的用戶預設 UI 語言進行當地語系化。

如需範例，請參閱 SetTimeZoneInformation。

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	timezoneapi.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll