GetTimeZoneInformation 関数 (timezoneapi.h)

現在のタイムゾーン設定を取得します。これらの設定は、協定世界時 (UTC) と現地時刻の間の変換を制御します。

年ごとに変更される夏時間の境界をサポートするには、 GetDynamicTimeZoneInformation または GetTimeZoneInformationForYear 関数を使用します。

構文

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

[out] lpTimeZoneInformation

現在の設定を受け取る TIME_ZONE_INFORMATION 構造体へのポインター。

関数が成功すると、次のいずれかの値が返されます。

リターンコード/値	Description
TIME_ZONE_ID_UNKNOWN 0	現在のタイムゾーンでは夏時間は使用されません。切り替え日が存在しないか、夏時間の自動調整が無効になっているためです。
TIME_ZONE_ID_STANDARD 1	システムは、TIME_ZONE_INFORMATION構造体の StandardDate メンバーの対象範囲で動作しています。
TIME_ZONE_ID_DAYLIGHT 2	システムは、TIME_ZONE_INFORMATION構造体の DaylightDate メンバーの対象範囲で動作しています。

メモリ不足エラーなどのその他の理由で関数が失敗した場合は、TIME_ZONE_ID_INVALIDを返します。詳細なエラー情報を得るには、GetLastError を呼び出します。

UTC 時刻と現地時刻の間のすべての変換は、次の数式に基づいています。

UTC = ローカル時間 + 時差

バイアスは、UTC 時刻と現地時刻の差 (分単位) です。

結果のTIME_ZONE_INFORMATION構造体の StandardName メンバーと DaylightName メンバーは、現在のユーザーの既定の UI 言語に従ってローカライズされます。

例については、「 SetTimeZoneInformation」を参照してください。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	timezoneapi.h (Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll