TIME_ZONE_INFORMATION
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| Bias | INT | 4 | +0 | +0 | このコンピューターでのローカル時刻変換に使用される現在のバイアス (分単位)。バイアスとは、協定世界時 (UTC) とローカル時刻の差 (分単位) です。UTC とローカル時刻の間のすべての変換は、次の式に基づいて行われます。 UTC = ローカル時刻 + バイアス このメンバーは必須です。 |
| StandardName | WCHAR | 64 | +4 | +4 | 標準時刻の説明です。たとえば "EST" は東部標準時を示します。この文字列は GetTimeZoneInformation 関数によって変更されずに返されます。この文字列は空でもかまいません。 |
| StandardDate | SYSTEMTIME | 16 | +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 回だけ発生します。それ以外の場合は、毎年発生する相対日付となります。 |
| StandardBias | INT | 4 | +84 | +84 | 標準時刻中に発生するローカル時刻変換で使用されるバイアス値です。StandardDate メンバーの値が指定されていない場合、このメンバーは無視されます。 この値は Bias メンバーの値に加算され、標準時刻中に使用されるバイアスになります。ほとんどのタイム ゾーンでは、このメンバーの値は 0 です。 |
| DaylightName | WCHAR | 64 | +88 | +88 | 夏時間の説明です。たとえば "PDT" は太平洋夏時間を示します。この文字列は GetTimeZoneInformation 関数によって変更されずに返されます。この文字列は空でもかまいません。 |
| DaylightDate | SYSTEMTIME | 16 | +152 | +152 | このオペレーティング システムで標準時刻から夏時間への移行が発生する日付とローカル時刻を格納する SYSTEMTIME 構造体です。タイム ゾーンが夏時間をサポートしていない場合、または呼び出し元が夏時間を無効にする必要がある場合は、 SYSTEMTIME 構造体の wMonth メンバーを 0 にしなければなりません。この日付を指定する場合は、この構造体の StandardDate メンバーも指定しなければなりません。 それ以外の場合、システムはタイム ゾーン データが無効であると見なし、変更は適用されません。 月内の正しい日を選択するには、wYear メンバーを 0 に、wHour メンバーと wMinute メンバーを移行時刻に、wDayOfWeek メンバーを該当する曜日に、wDay メンバーをその月における該当する曜日の出現回数 (1 から 5。その曜日が月内に 5 回出現しない場合、5 はその月の最後の出現を示します) に設定します。 wYear メンバーが 0 でない場合、移行日は絶対日付となり、1 回だけ発生します。それ以外の場合は、毎年発生する相対日付となります。 |
| DaylightBias | INT | 4 | +168 | +168 | 夏時間中に発生するローカル時刻変換で使用されるバイアス値です。DaylightDate メンバーの値が指定されていない場合、このメンバーは無視されます。 この値は Bias メンバーの値に加算され、夏時間中に使用されるバイアスになります。ほとんどのタイム ゾーンでは、このメンバーの値は –60 です。 |
公式ドキュメント
タイム ゾーンの設定を指定します。
解説(Remarks)
各タイム ゾーンの設定は、次のレジストリ キーに格納されます。
HKEY_LOCAL_MACHINE
SOFTWARE
Microsoft
Windows NT
CurrentVersion
Time Zones
time_zone_name
各タイム ゾーンのエントリには、次のレジストリ値が含まれます。
| レジストリ値 | 型 | 説明 |
|---|---|---|
| Display | REG_SZ | 表示名。 |
| Dlt | REG_SZ | 夏時間の説明。 |
| MUI_Display | REG_SZ | @path,-stringID[;comment] という形式の文字列で表した表示名。詳細については、MUI を参照してください。 |
| MUI_Dlt | REG_SZ | @path,-stringID[;comment] という形式の文字列で表した夏時間の説明。 |
| MUI_Std | REG_SZ | @path,-stringID[;comment] という形式の文字列で表した標準時刻の説明。 |
| Std | REG_SZ | 標準時刻の説明。 |
| TZI | REG_BINARY |
次のタイム ゾーン情報。
|
Dynamic DST キーの詳細については、DYNAMIC_TIME_ZONE_INFORMATION を参照してください。
StandardName と DaylightName はどちらも、現在のユーザー既定の UI 言語に従ってローカライズされます。
例
例については、SetTimeZoneInformation を参照してください。
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;
// TIME_ZONE_INFORMATION (x64 172 / x86 172 バイト)
typedef struct TIME_ZONE_INFORMATION {
INT Bias;
WCHAR StandardName[32];
SYSTEMTIME StandardDate;
INT StandardBias;
WCHAR DaylightName[32];
SYSTEMTIME DaylightDate;
INT DaylightBias;
} 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 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;
}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 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
End Structureimport 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 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),
]#[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 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,
}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 TIME_ZONE_INFORMATION struct {
Bias int32
StandardName [32]uint16
StandardDate SYSTEMTIME
StandardBias int32
DaylightName [32]uint16
DaylightDate SYSTEMTIME
DaylightBias int32
}type
SYSTEMTIME = record
wYear: Word;
wMonth: Word;
wDayOfWeek: Word;
wDay: Word;
wHour: Word;
wMinute: Word;
wSecond: Word;
wMilliseconds: Word;
end;
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;
end;const SYSTEMTIME = extern struct {
wYear: u16,
wMonth: u16,
wDayOfWeek: u16,
wDay: u16,
wHour: u16,
wMinute: u16,
wSecond: u16,
wMilliseconds: u16,
};
const TIME_ZONE_INFORMATION = extern struct {
Bias: i32,
StandardName: [32]u16,
StandardDate: SYSTEMTIME,
StandardBias: i32,
DaylightName: [32]u16,
DaylightDate: SYSTEMTIME,
DaylightBias: i32,
};type
SYSTEMTIME {.bycopy.} = object
wYear: uint16
wMonth: uint16
wDayOfWeek: uint16
wDay: uint16
wHour: uint16
wMinute: uint16
wSecond: uint16
wMilliseconds: uint16
TIME_ZONE_INFORMATION {.bycopy.} = object
Bias: int32
StandardName: array[32, uint16]
StandardDate: SYSTEMTIME
StandardBias: int32
DaylightName: array[32, uint16]
DaylightDate: SYSTEMTIME
DaylightBias: int32struct SYSTEMTIME
{
ushort wYear;
ushort wMonth;
ushort wDayOfWeek;
ushort wDay;
ushort wHour;
ushort wMinute;
ushort wSecond;
ushort wMilliseconds;
}
struct TIME_ZONE_INFORMATION
{
int Bias;
wchar[32] StandardName;
SYSTEMTIME StandardDate;
int StandardBias;
wchar[32] DaylightName;
SYSTEMTIME DaylightDate;
int DaylightBias;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; TIME_ZONE_INFORMATION サイズ: 172 バイト(x64)
dim st, 43 ; 4byte整数×43(構造体サイズ 172 / 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 も可)
; ※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 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
#endstruct
stdim st, TIME_ZONE_INFORMATION ; NSTRUCT 変数を確保
st->Bias = 100
mes "Bias=" + st->Bias