共用方式為


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 結構的指標。

如果 lpTimeZoneNULL,函式會使用目前使用中的時區。

[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

另請參閱

GetSystemTime

GetTimeZoneInformation

SYSTEMTIME

系統時間

TIME_ZONE_INFORMATION

時間函數

TzSpecificLocalTimeToSystemTime