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 言語に従ってローカライズされます。

要件

関連項目

DYNAMIC_TIME_ZONE_INFORMATION

現地時刻

TIME_ZONE_INFORMATION

時間関数