GetTimeZoneInformationForYear

指定した年とタイムゾーンのタイムゾーン設定を取得する。これらの設定は協定世界時 (UTC) とローカル時刻間の変換を制御する。

GetTimeZoneInformationForYear wYear, pdtzi, ptzi

wYear : [int] タイムゾーン設定を取得する年。wYear パラメータはローカル時刻値でなければならない。
pdtzi : [var] タイムゾーンを指定する DYNAMIC_TIME_ZONE_INFORMATION 構造体へのポインタ。このパラメータを設定するには、必要なタイムゾーンのインデックスを指定して EnumDynamicTimeZoneInformation を呼ぶ。このパラメータが NULL の場合、現在のタイムゾーンが使用される。
ptzi : [var] タイムゾーン設定を受け取る TIME_ZONE_INFORMATION 構造体へのポインタ。

(プラグイン / モジュール : kernel32.dll)

解説

指定した年とタイムゾーンのタイムゾーン設定を取得する。これらの設定は協定世界時 (UTC) とローカル時刻間の変換を制御する。

[戻り値]
関数が成功した場合、戻り値は 0 以外。関数が失敗した場合、戻り値は 0。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
wYear パラメータはローカル時刻値とみなされる。ローカル時刻が古い年と新しい年の遷移(1 月 1 日
00:00:00)に近い場合、UTC の年を GetTimeZoneInformationForYear
関数に渡すと、関数は誤った年のタイムゾーン設定を返す可能性がある。結果の TIME_ZONE_INFORMATION 構造体の
StandardName と DaylightName メンバは、現在のユーザー既定 UI 言語に従ってローカライズされる。

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs