TIME_ZONE_INFORMATION結構 (timezoneapi.h)

  • 發行項

指定時區的設定。

語法

typedef struct _TIME_ZONE_INFORMATION {
  LONG       Bias;
  WCHAR      StandardName[32];
  SYSTEMTIME StandardDate;
  LONG       StandardBias;
  WCHAR      DaylightName[32];
  SYSTEMTIME DaylightDate;
  LONG       DaylightBias;
} TIME_ZONE_INFORMATION, *PTIME_ZONE_INFORMATION, *LPTIME_ZONE_INFORMATION;

成員

Bias

這部電腦上目前的本地時間轉譯偏差 (以分鐘為單位)。 偏差是國際標準時間 (UTC) 與當地時間之間的差異，以分鐘為單位。 UTC 和當地時間之間的所有翻譯都是以下列公式為基礎：

UTC = 當地時間 + 偏差

這是必要成員。

StandardName[32]

標準時間的描述。 例如，「EST」 可能表示東部標準時間。 GetTimeZoneInformation函式會以未變更的方式傳回字串。 此字串可以是空的。

StandardDate

SYSTEMTIME結構，包含從日光節約時間轉換至標準時間在此作業系統上發生的日期和時間。 如果時區不支援日光節約時間，或呼叫端需要停用日光節約時間，則 SYSTEMTIME結構中的wMonth成員必須是零。 如果指定這個日期，也必須指定這個 結構的 DaylightDate 成員。

否則，系統會假設時區資料無效，且不會套用任何變更。

若要選取月份中的正確日期，請將 wYear 成員設定為零、 wHour 和 wMinute 成員轉換為轉換時間、 將 wDayOfWeek 成員設定為適當的工作日，而 wDay 成員則表示當月內的星期幾發生時間 (1 到 5，其中 5 表示當月最後一次發生，如果該星期幾未發生 5 次) 。

使用此標記法，在 4 月的第一個星期日指定 02：00，如下所示： wHour = 2、 wMonth = 4、 wDayOfWeek = 0、 wDay = 1。 在 10 月的最後一個星期四指定 02：00，如下所示： wHour = 2， wMonth = 10， wDayOfWeek = 4， wDay = 5。

如果 wYear 成員不是零，則轉換日期是絕對的;它只會發生一次。 否則，它是每年發生的相對日期。

StandardBias

在標準時間期間發生的當地時間轉譯期間所要使用的偏差值。 如果未提供 StandardDate 成員的值，則會忽略這個成員。

這個值會新增至 Bias 成員的值，以形成標準時間中使用的偏差。 在大部分的時區中，這個成員的值是零。

DaylightName[32]

日光節約時間的描述。 例如，「PDT」 可能表示太平洋日光節約時間。 GetTimeZoneInformation函式會以未變更的方式傳回字串。 此字串可以是空的。

DaylightDate

SYSTEMTIME結構，包含從標準時間轉換到日光節約時間在此作業系統上發生的日期和當地時間。 如果時區不支援日光節約時間，或呼叫端需要停用日光節約時間，則 SYSTEMTIME結構中的wMonth成員必須是零。 如果指定這個日期，也必須指定這個結構中的 StandardDate 成員。

否則，系統會假設時區資料無效，且不會套用任何變更。

若要選取月份中的正確日期，請將 wYear 成員設定為零、 wHour 和 wMinute 成員轉換為轉換時間、 將 wDayOfWeek 成員設定為適當的工作日，而 wDay 成員則表示當月內的星期幾發生時間 (1 到 5，其中 5 表示當月最後一次發生，如果該星期幾未發生 5 次) 。

如果 wYear 成員不是零，則轉換日期是絕對的;它只會發生一次。 否則，它是每年發生的相對日期。

DaylightBias

在日光節約時間期間發生的當地時間翻譯期間所要使用的偏差值。 如果未提供 DaylightDate 成員的值，則會忽略此成員。

這個值會新增至 Bias 成員的值，以形成日光節約時間期間所使用的偏差。 在大部分的時區中，此成員的值是 –60。

備註

每個時區的設定都會儲存在下列登錄機碼中：

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows NT
            CurrentVersion
               Time Zones
                  time_zone_name

每個時區專案都包含下列登錄值。

登錄值 類型 描述
顯示器 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]。
性病 REG_SZ 標準時間的描述。
TZI REG_BINARY 下列時區資訊。 
typedef struct _REG_TZI_FORMAT
{
    LONG Bias;
    LONG StandardBias;
    LONG DaylightBias;
    SYSTEMTIME StandardDate;
    SYSTEMTIME DaylightDate;
} REG_TZI_FORMAT;
 

如需 動態 DST 金鑰的詳細資訊，請參閱 DYNAMIC_TIME_ZONE_INFORMATION。

StandardName和DaylightName都會根據目前的使用者預設 UI 語言進行當地語系化。

範例

如需範例，請參閱 SetTimeZoneInformation。

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
標頭 timezoneapi.h (包含 Windows.h)

另請參閱

DYNAMIC_TIME_ZONE_INFORMATION

GetTimeZoneInformation

SYSTEMTIME

SetTimeZoneInformation