次の方法で共有


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

関連項目

GetDynamicTimeZoneInformation

GetTimeZoneInformationForYear

ローカル時刻

SetTimeZoneInformation

TIME_ZONE_INFORMATION

時間関数