GetTimeZoneInformationForYear 関数 (timezoneapi.h)
指定した年とタイム ゾーンのタイム ゾーン設定を取得します。 これらの設定は、協定世界時 (UTC) と現地時刻の間の変換を制御します。
構文
BOOL GetTimeZoneInformationForYear(
[in] USHORT wYear,
[in, optional] PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,
[out] LPTIME_ZONE_INFORMATION ptzi
);
パラメーター
[in] wYear
タイム ゾーン設定を取得する年。 wYear パラメーターはローカル時刻値である必要があります。
[in, optional] pdtzi
タイム ゾーンを指定する DYNAMIC_TIME_ZONE_INFORMATION 構造体へのポインター。 このパラメーターを設定するには、 EnumDynamicTimeZoneInformation を呼び出し、必要なタイム ゾーンのインデックスを指定します。 このパラメーターが NULL の場合は、現在のタイム ゾーンが使用されます。
[out] ptzi
タイム ゾーン設定を受け取る TIME_ZONE_INFORMATION 構造体へのポインター。
戻り値
関数が成功すると、戻り値は 0 以外になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
解説
wYear パラメーターは、ローカル時刻値と見なされます。 現地時刻が旧年と新年 (1 月 1 日 00:00:00) の間の遷移に近い場合、UTC 年を GetTimeZoneInformationForYear 関数に渡すと、関数が間違った年のタイム ゾーン設定を返す可能性があります。
結果のTIME_ZONE_INFORMATION構造体の StandardName メンバーと DaylightName メンバーは、現在のユーザーの既定の UI 言語に従ってローカライズされます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista と SP1 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | timezoneapi.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |