GetTimeZoneInformation 関数 (timezoneapi.h)
現在のタイム ゾーン設定を取得します。 これらの設定は、協定世界時 (UTC) と現地時刻の間の変換を制御します。
年ごとに変更される夏時間の境界をサポートするには、 GetDynamicTimeZoneInformation または GetTimeZoneInformationForYear 関数を 使用します。
構文
DWORD GetTimeZoneInformation(
[out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);
パラメーター
[out] lpTimeZoneInformation
現在の設定を受け取る TIME_ZONE_INFORMATION 構造体へのポインター。
戻り値
関数が成功すると、次のいずれかの値が返されます。
| リターン コード/値 | Description |
|---|---|
|
現在のタイム ゾーンでは夏時間は使用されません。切り替え日が存在しないか、夏時間の自動調整が無効になっているためです。 |
|
システムは、TIME_ZONE_INFORMATION構造体の StandardDate メンバーの対象範囲で動作しています。 |
|
システムは、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 |