Win32 API 日本語リファレンス
ホームSystem.Time › DYNAMIC_TIME_ZONE_INFORMATION

DYNAMIC_TIME_ZONE_INFORMATION

構造体
サイズx64: 432 バイト / x86: 432 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
BiasINT4+0+0

このコンピューター上でのローカル時刻変換に使用される現在のバイアス (分単位)。バイアスとは、協定世界時 (UTC) とローカル時刻との差 (分単位) です。UTC とローカル時刻の間の変換は、すべて次の式に基づいて行われます。

UTC = local time + bias

このメンバーは必須です。

StandardNameWCHAR64+4+4標準時の説明。たとえば "EST" は東部標準時を表します。この文字列は GetDynamicTimeZoneInformation 関数によって変更されずに返されます。この文字列は空でもかまいません。
StandardDateSYSTEMTIME16+68+68

このオペレーティングシステムで夏時間から標準時への切り替えが発生する日付とローカル時刻を格納する SYSTEMTIME 構造体。 タイムゾーンが夏時間をサポートしていない場合、または呼び出し元が夏時間を無効にする必要がある場合、 SYSTEMTIME 構造体の wMonth メンバーは 0 でなければなりません。この日付を指定する場合は、 この構造体の DaylightDate メンバーも指定しなければなりません。 そうしないと、システムはタイムゾーンデータが無効であると見なし、変更は適用されません。

月内の正しい日を選択するには、wYear メンバーを 0 に、 wHour メンバーと wMinute メンバーを切り替え時刻に、 wDayOfWeek メンバーを該当する曜日に、 wDay メンバーをその月における該当曜日の出現回数 (1 ~ 5。5 はその曜日が月内に 5 回出現しない場合は月内の最後の出現を示します) に設定します。

この表記を使用すると、4 月の第 1 日曜日の 02:00 は次のように指定します。 wHour = 2、wMonth = 4、 wDayOfWeek = 0、wDay = 1。10 月の最後の木曜日の 02:00 は次のように指定します。 wHour = 2、wMonth = 10、 wDayOfWeek = 4、wDay = 5。

wYear メンバーが 0 以外の場合、切り替え日は絶対日付となり、1 回だけ発生します。 それ以外の場合は、毎年発生する相対日付となります。

StandardBiasINT4+84+84

標準時の期間に行われるローカル時刻変換で使用されるバイアス値。StandardDate メンバーの値が指定されていない場合、 このメンバーは無視されます。

この値は Bias メンバーの値に加算され、標準時の期間に使用されるバイアスとなります。 ほとんどのタイムゾーンでは、このメンバーの値は 0 です。

DaylightNameWCHAR64+88+88夏時間 (DST) の説明。たとえば "PDT" は太平洋夏時間を表します。この文字列は GetDynamicTimeZoneInformation 関数によって変更されずに返されます。この文字列は空でもかまいません。
DaylightDateSYSTEMTIME16+152+152

このオペレーティングシステムで標準時から夏時間への切り替えが発生する日付とローカル時刻を格納する SYSTEMTIME 構造体。 タイムゾーンが夏時間をサポートしていない場合、または呼び出し元が夏時間を無効にする必要がある場合、 SYSTEMTIME 構造体の wMonth メンバーは 0 でなければなりません。この日付を指定する場合は、 この構造体の StandardDate メンバーも指定しなければなりません。 そうしないと、システムはタイムゾーンデータが無効であると見なし、変更は適用されません。

月内の正しい日を選択するには、wYear メンバーを 0 に、 wHour メンバーと wMinute メンバーを切り替え時刻に、 wDayOfWeek メンバーを該当する曜日に、 wDay メンバーをその月における該当曜日の出現回数 (1 ~ 5。5 はその曜日が月内に 5 回出現しない場合は月内の最後の出現を示します) に設定します。

wYear メンバーが 0 以外の場合、切り替え日は絶対日付となり、1 回だけ発生します。 それ以外の場合は、毎年発生する相対日付となります。

DaylightBiasINT4+168+168

夏時間の期間に行われるローカル時刻変換で使用されるバイアス値。DaylightDate メンバーの値が指定されていない場合、 このメンバーは無視されます。

この値は Bias メンバーの値に加算され、夏時間の期間に使用されるバイアスとなります。 ほとんどのタイムゾーンでは、このメンバーの値は –60 です。

TimeZoneKeyNameWCHAR256+172+172ローカルコンピューター上のタイムゾーンレジストリキーの名前。詳細については「解説」を参照してください。
DynamicDaylightTimeDisabledBOOLEAN1+428+428

動的な夏時間が無効になっているかどうかを示します。このメンバーを TRUE に設定すると動的な夏時間が無効になり、 システムは固定された切り替え日のセットを使用するようになります。

動的な夏時間を元に戻すには、DynamicDaylightTimeDisabledFALSE に設定して SetDynamicTimeZoneInformation 関数を呼び出します。システムは、次回の時刻更新時、次回のシステム再起動時、または暦年の終わりのいずれか早い時点で、 現在の年の切り替え日を読み取ります。

GetDynamicTimeZoneInformation 関数を呼び出したときに、タイムゾーンが SetDynamicTimeZoneInformation ではなく SetTimeZoneInformation 関数を使用して設定された場合、 またはユーザーがコントロールパネルの「日付と時刻」アプリケーションでこの機能を無効にしている場合、このメンバーは TRUE になります。

夏時間を無効にするには、このメンバーを TRUE に設定し、 StandardDate メンバーと DaylightDate メンバーをクリアしてから SetDynamicTimeZoneInformation を呼び出します。 夏時間を元に戻すには、DynamicDaylightTimeDisabledFALSE に設定して SetDynamicTimeZoneInformation を呼び出します。

公式ドキュメント

タイムゾーンと動的な夏時間の設定を指定します。

解説(Remarks)

動的な夏時間は、夏時間の境界が年ごとに変化するタイムゾーンをサポートします。この機能により、特に年ごとの DST の境界が あらかじめ判明しているロケールで、システムの更新が容易になります。タイムゾーンが更新された後は、対象の時刻がタイムゾーンの 変更前のものであっても、現在のタイムゾーン設定がすべての時刻操作に適用されます。そのため、UTC 時刻を保存しておき、 現在のローカルタイムゾーンに変換して使用することをお勧めします。

現在の年の切り替え日は、 SetDynamicTimeZoneInformation 関数を使用して設定できます。 将来の切り替え日を設定するには、レジストリデータにエントリを追加する必要があります。動的な夏時間の設定は、 次のレジストリキーに格納されます。

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows NT
            CurrentVersion
               Time Zones
                  time_zone_name
                     Dynamic DST

Dynamic DST キーには、次のレジストリ値が含まれます。

レジストリ値 説明
FirstEntry REG_DWORD テーブル内の最初の年。
LastEntry REG_DWORD テーブル内の最後の年。
year1 REG_BINARY 次のタイムゾーン情報。
typedef struct _REG_TZI_FORMAT
{
    LONG Bias;
    LONG StandardBias;
    LONG DaylightBias;
    SYSTEMTIME StandardDate;
    SYSTEMTIME DaylightDate;
} REG_TZI_FORMAT;
year2 REG_BINARY REG_TZI_FORMAT 構造体。
yearN REG_BINARY REG_TZI_FORMAT 構造体。

Time Zones キー内のその他の値の詳細については、 TIME_ZONE_INFORMATION を参照してください。

StandardNameDaylightName はどちらも、現在のユーザー既定の UI 言語に従ってローカライズされます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// SYSTEMTIME  (x64 16 / x86 16 バイト)
typedef struct SYSTEMTIME {
    WORD wYear;
    WORD wMonth;
    WORD wDayOfWeek;
    WORD wDay;
    WORD wHour;
    WORD wMinute;
    WORD wSecond;
    WORD wMilliseconds;
} SYSTEMTIME;

// DYNAMIC_TIME_ZONE_INFORMATION  (x64 432 / x86 432 バイト)
typedef struct DYNAMIC_TIME_ZONE_INFORMATION {
    INT Bias;
    WCHAR StandardName[32];
    SYSTEMTIME StandardDate;
    INT StandardBias;
    WCHAR DaylightName[32];
    SYSTEMTIME DaylightDate;
    INT DaylightBias;
    WCHAR TimeZoneKeyName[128];
    BOOLEAN DynamicDaylightTimeDisabled;
} DYNAMIC_TIME_ZONE_INFORMATION;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SYSTEMTIME
{
    public ushort wYear;
    public ushort wMonth;
    public ushort wDayOfWeek;
    public ushort wDay;
    public ushort wHour;
    public ushort wMinute;
    public ushort wSecond;
    public ushort wMilliseconds;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DYNAMIC_TIME_ZONE_INFORMATION
{
    public int Bias;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)] public string StandardName;
    public SYSTEMTIME StandardDate;
    public int StandardBias;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)] public string DaylightName;
    public SYSTEMTIME DaylightDate;
    public int DaylightBias;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 128)] public string TimeZoneKeyName;
    [MarshalAs(UnmanagedType.U1)] public bool DynamicDaylightTimeDisabled;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SYSTEMTIME
    Public wYear As UShort
    Public wMonth As UShort
    Public wDayOfWeek As UShort
    Public wDay As UShort
    Public wHour As UShort
    Public wMinute As UShort
    Public wSecond As UShort
    Public wMilliseconds As UShort
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DYNAMIC_TIME_ZONE_INFORMATION
    Public Bias As Integer
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=32)> Public StandardName As String
    Public StandardDate As SYSTEMTIME
    Public StandardBias As Integer
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=32)> Public DaylightName As String
    Public DaylightDate As SYSTEMTIME
    Public DaylightBias As Integer
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=128)> Public TimeZoneKeyName As String
    <MarshalAs(UnmanagedType.U1)> Public DynamicDaylightTimeDisabled As Boolean
End Structure
import ctypes
from ctypes import wintypes

class SYSTEMTIME(ctypes.Structure):
    _fields_ = [
        ("wYear", ctypes.c_ushort),
        ("wMonth", ctypes.c_ushort),
        ("wDayOfWeek", ctypes.c_ushort),
        ("wDay", ctypes.c_ushort),
        ("wHour", ctypes.c_ushort),
        ("wMinute", ctypes.c_ushort),
        ("wSecond", ctypes.c_ushort),
        ("wMilliseconds", ctypes.c_ushort),
    ]

class DYNAMIC_TIME_ZONE_INFORMATION(ctypes.Structure):
    _fields_ = [
        ("Bias", ctypes.c_int),
        ("StandardName", ctypes.c_wchar * 32),
        ("StandardDate", SYSTEMTIME),
        ("StandardBias", ctypes.c_int),
        ("DaylightName", ctypes.c_wchar * 32),
        ("DaylightDate", SYSTEMTIME),
        ("DaylightBias", ctypes.c_int),
        ("TimeZoneKeyName", ctypes.c_wchar * 128),
        ("DynamicDaylightTimeDisabled", ctypes.c_byte),
    ]
#[repr(C)]
pub struct SYSTEMTIME {
    pub wYear: u16,
    pub wMonth: u16,
    pub wDayOfWeek: u16,
    pub wDay: u16,
    pub wHour: u16,
    pub wMinute: u16,
    pub wSecond: u16,
    pub wMilliseconds: u16,
}

#[repr(C)]
pub struct DYNAMIC_TIME_ZONE_INFORMATION {
    pub Bias: i32,
    pub StandardName: [u16; 32],
    pub StandardDate: SYSTEMTIME,
    pub StandardBias: i32,
    pub DaylightName: [u16; 32],
    pub DaylightDate: SYSTEMTIME,
    pub DaylightBias: i32,
    pub TimeZoneKeyName: [u16; 128],
    pub DynamicDaylightTimeDisabled: u8,
}
import "golang.org/x/sys/windows"

type SYSTEMTIME struct {
	wYear uint16
	wMonth uint16
	wDayOfWeek uint16
	wDay uint16
	wHour uint16
	wMinute uint16
	wSecond uint16
	wMilliseconds uint16
}

type DYNAMIC_TIME_ZONE_INFORMATION struct {
	Bias int32
	StandardName [32]uint16
	StandardDate SYSTEMTIME
	StandardBias int32
	DaylightName [32]uint16
	DaylightDate SYSTEMTIME
	DaylightBias int32
	TimeZoneKeyName [128]uint16
	DynamicDaylightTimeDisabled byte
}
type
  SYSTEMTIME = record
    wYear: Word;
    wMonth: Word;
    wDayOfWeek: Word;
    wDay: Word;
    wHour: Word;
    wMinute: Word;
    wSecond: Word;
    wMilliseconds: Word;
  end;

  DYNAMIC_TIME_ZONE_INFORMATION = record
    Bias: Integer;
    StandardName: array[0..31] of WideChar;
    StandardDate: SYSTEMTIME;
    StandardBias: Integer;
    DaylightName: array[0..31] of WideChar;
    DaylightDate: SYSTEMTIME;
    DaylightBias: Integer;
    TimeZoneKeyName: array[0..127] of WideChar;
    DynamicDaylightTimeDisabled: ByteBool;
  end;
const SYSTEMTIME = extern struct {
    wYear: u16,
    wMonth: u16,
    wDayOfWeek: u16,
    wDay: u16,
    wHour: u16,
    wMinute: u16,
    wSecond: u16,
    wMilliseconds: u16,
};

const DYNAMIC_TIME_ZONE_INFORMATION = extern struct {
    Bias: i32,
    StandardName: [32]u16,
    StandardDate: SYSTEMTIME,
    StandardBias: i32,
    DaylightName: [32]u16,
    DaylightDate: SYSTEMTIME,
    DaylightBias: i32,
    TimeZoneKeyName: [128]u16,
    DynamicDaylightTimeDisabled: u8,
};
type
  SYSTEMTIME {.bycopy.} = object
    wYear: uint16
    wMonth: uint16
    wDayOfWeek: uint16
    wDay: uint16
    wHour: uint16
    wMinute: uint16
    wSecond: uint16
    wMilliseconds: uint16

  DYNAMIC_TIME_ZONE_INFORMATION {.bycopy.} = object
    Bias: int32
    StandardName: array[32, uint16]
    StandardDate: SYSTEMTIME
    StandardBias: int32
    DaylightName: array[32, uint16]
    DaylightDate: SYSTEMTIME
    DaylightBias: int32
    TimeZoneKeyName: array[128, uint16]
    DynamicDaylightTimeDisabled: uint8
struct SYSTEMTIME
{
    ushort wYear;
    ushort wMonth;
    ushort wDayOfWeek;
    ushort wDay;
    ushort wHour;
    ushort wMinute;
    ushort wSecond;
    ushort wMilliseconds;
}

struct DYNAMIC_TIME_ZONE_INFORMATION
{
    int Bias;
    wchar[32] StandardName;
    SYSTEMTIME StandardDate;
    int StandardBias;
    wchar[32] DaylightName;
    SYSTEMTIME DaylightDate;
    int DaylightBias;
    wchar[128] TimeZoneKeyName;
    ubyte DynamicDaylightTimeDisabled;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DYNAMIC_TIME_ZONE_INFORMATION サイズ: 432 バイト(x64)
dim st, 108    ; 4byte整数×108(構造体サイズ 432 / 4 切り上げ)
; Bias : INT (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; StandardName : WCHAR (+4, 64byte)  varptr(st)+4 を基点に操作(64byte:入れ子/配列)
; StandardDate : SYSTEMTIME (+68, 16byte)  varptr(st)+68 を基点に操作(16byte:入れ子/配列)
; StandardBias : INT (+84, 4byte)  st.21 = 値  /  値 = st.21   (lpoke/lpeek も可)
; DaylightName : WCHAR (+88, 64byte)  varptr(st)+88 を基点に操作(64byte:入れ子/配列)
; DaylightDate : SYSTEMTIME (+152, 16byte)  varptr(st)+152 を基点に操作(16byte:入れ子/配列)
; DaylightBias : INT (+168, 4byte)  st.42 = 値  /  値 = st.42   (lpoke/lpeek も可)
; TimeZoneKeyName : WCHAR (+172, 256byte)  varptr(st)+172 を基点に操作(256byte:入れ子/配列)
; DynamicDaylightTimeDisabled : BOOLEAN (+428, 1byte)  poke st,428,値  /  値 = peek(st,428)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global SYSTEMTIME
    #field short wYear
    #field short wMonth
    #field short wDayOfWeek
    #field short wDay
    #field short wHour
    #field short wMinute
    #field short wSecond
    #field short wMilliseconds
#endstruct

#defstruct global DYNAMIC_TIME_ZONE_INFORMATION
    #field int Bias
    #field wchar StandardName 32
    #field SYSTEMTIME StandardDate
    #field int StandardBias
    #field wchar DaylightName 32
    #field SYSTEMTIME DaylightDate
    #field int DaylightBias
    #field wchar TimeZoneKeyName 128
    #field bool1 DynamicDaylightTimeDisabled
#endstruct

stdim st, DYNAMIC_TIME_ZONE_INFORMATION        ; NSTRUCT 変数を確保
st->Bias = 100
mes "Bias=" + st->Bias