GetTimeZoneInformation 函式 (timezoneapi.h)
擷取目前的時區設定。 這些設定可控制國際標準時間 (UTC) 和當地時間之間的翻譯。
若要支援從年份變更為年份的日光節約時間界限，請使用 GetDynamicTimeZoneInformation 或 GetTimeZoneInformationForYear 函式。
語法
DWORD GetTimeZoneInformation(
[out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);
參數
[out] lpTimeZoneInformation
要接收目前設定之 TIME_ZONE_INFORMATION 結構的指標。
傳回值
如果函式成功，它會傳回下列其中一個值。
| 傳回碼/值 | Description |
|---|---|
|
日光節約時間不會用於目前的時區，因為不會停用日光節約時間的轉換日期或自動調整。 |
|
系統會在 TIME_ZONE_INFORMATION 結構的 StandardDate 成員所涵蓋的範圍中運作。 |
|
系統會在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 |