TzSpecificLocalTimeToSystemTime 函式 (timezoneapi.h)
將當地時間轉換成國際標準時間 (UTC) 的時間。
語法
BOOL TzSpecificLocalTimeToSystemTime(
[in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
[in] const SYSTEMTIME *lpLocalTime,
[out] LPSYSTEMTIME lpUniversalTime
);
參數
[in, optional] lpTimeZoneInformation
TIME_ZONE_INFORMATION 結構的指標,指定 lpLocalTime 中所指定時間的時區。
如果 lpTimeZoneInformation 為 NULL,函式會使用目前使用中的時區。
[in] lpLocalTime
SYSTEMTIME 結構的指標,指定要轉換的當地時間。 函式會將這個時間轉換為對應的UTC時間。
[out] lpUniversalTime
接收UTC時間 之SYSTEMTIME 結構的指標。
傳回值
如果函式成功,傳回值為非零值,而函式會將 lpUniversalTime 所指向之 SYSTEMTIME 結構的成員設定為適當的值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
TzSpecificLocalTimeToSystemTime 會考慮日光節約時間 (DST) 是否對要轉換的當地時間生效。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | timezoneapi.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |