共用方式為


GetTimeZoneInformation 函式 (timezoneapi.h)

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

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

語法

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結構的 StandardNameDaylightName 成員會根據目前的用戶預設 UI 語言進行當地語系化。

範例

如需範例,請參閱 SetTimeZoneInformation

規格需求

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

另請參閱

GetDynamicTimeZoneInformation

GetTimeZoneInformationForYear

當地時間

SetTimeZoneInformation

TIME_ZONE_INFORMATION

時間函式