SystemTimeToTzSpecificLocalTime 函式 (timezoneapi.h)
將國際標準時間 (UTC) 的時間轉換為指定時區的對應當地時間。
語法
BOOL SystemTimeToTzSpecificLocalTime(
[in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
[in] const SYSTEMTIME *lpUniversalTime,
[out] LPSYSTEMTIME lpLocalTime
);
參數
[in, optional] lpTimeZoneInformation
指定感興趣時區 之TIME_ZONE_INFORMATION 結構的指標。
如果 lpTimeZone 為 NULL，函式會使用目前使用中的時區。
[in] lpUniversalTime
SYSTEMTIME 結構的指標，指定要轉換的 UTC 時間。 函式會將這個通用時間轉換為指定時區的對應當地時間。
[out] lpLocalTime
接收當地時間 之 SYSTEMTIME 結構的指標。
傳回值
如果函式成功，傳回值為非零值，而函式會將 lpLocalTime 指向之 SYSTEMTIME 結構的成員設定為適當的當地時間值。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
SystemTimeToTzSpecificLocalTime 函式會考慮日光節約時間 (DST) 是否在要轉換系統時間的當地時間生效。
SystemTimeToTzSpecificLocalTime 函式可能會在下列情況下不正確地計算當地時間：
- 時區會針對舊年和新年使用不同的UTC位移。
- 要轉換的 UTC 時間以及計算的當地時間在不同的年份中。
範例
如需範例，請參閱 擷取 Last-Write 時間。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | timezoneapi.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |