SystemTimeToTzSpecificLocalTime 函式 (timezoneapi.h)

發行項
03/05/2024

將國際標準時間 (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