TIME_ZONE_INFORMATION-Struktur (timezoneapi.h)

Artikel
08/26/2023

Gibt Einstellungen für eine Zeitzone an.

Syntax

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;

Member

Bias

Der aktuelle Zeitunterschied in Minuten für die lokale Zeitübersetzung auf diesem Computer. Die Verzerrung ist der Unterschied zwischen koordinierter Weltzeit (UTC) und Ortszeit in Minuten. Alle Übersetzungen zwischen UTC und Ortszeit basieren auf der folgenden Formel:

UTC = Ortszeit + Bias

Dieses Element ist erforderlich.

StandardName[32]

Eine Beschreibung für die Standardzeit. Beispielsweise könnte "EST" die Östliche Normalzeit angeben. Die Zeichenfolge wird unverändert von der GetTimeZoneInformation-Funktion zurückgegeben. Diese Zeichenfolge kann leer sein.

StandardDate

Eine SYSTEMTIME-Struktur , die ein Datum und eine Ortszeit enthält, an der der Übergang von der Sommerzeit zur Standardzeit unter diesem Betriebssystem stattfindet. Wenn die Zeitzone keine Sommerzeit unterstützt oder der Anrufer die Sommerzeit deaktivieren muss, muss der wMonth-Member in der SYSTEMTIME-Struktur 0 sein. Wenn dieses Datum angegeben wird, muss auch das DaylightDate-Element dieser Struktur angegeben werden.

Andernfalls geht das System davon aus, dass die Zeitzonendaten ungültig sind und keine Änderungen angewendet werden.

Um den richtigen Tag im Monat auszuwählen, legen Sie das wYear-Element auf Null, die wHour - und wMinute-Member auf die Übergangszeit, das wDayOfWeek-Element auf den entsprechenden Wochentag und das wDay-Element fest, um das Vorkommen des Wochentags innerhalb des Monats anzugeben (1 bis 5, wobei 5 das endgültige Vorkommen während des Monats angibt, wenn dieser Wochentag nicht 5 Mal auftritt).

Geben Sie mit dieser Notation 02:00 am ersten Sonntag im April wie folgt an: wHour = 2, wMonth = 4, wDayOfWeek = 0, wDay = 1. Geben Sie 02:00 am letzten Donnerstag im Oktober wie folgt an: wHour = 2, wMonth = 10, wDayOfWeek = 4, wDay = 5.

Wenn das wYear-Element nicht 0 ist, ist das Übergangsdatum absolut; Es tritt nur einmal auf. Andernfalls handelt es sich um ein relatives Datum, das jährlich auftritt.

StandardBias

Der Biaswert, der während der Ortszeitübersetzungen verwendet werden soll, die während der Standardzeit auftreten. Dieser Member wird ignoriert, wenn kein Wert für das StandardDate-Element angegeben wird.

Dieser Wert wird dem Wert des Bias-Elements hinzugefügt, um die während der Standardzeit verwendete Verzerrung zu bilden. In den meisten Zeitzonen ist der Wert dieses Members 0.

DaylightName[32]

Eine Beschreibung für die Sommerzeit. Beispielsweise könnte "PDT" die Pacific Daylight Time angeben. Die Zeichenfolge wird unverändert von der GetTimeZoneInformation-Funktion zurückgegeben. Diese Zeichenfolge kann leer sein.

DaylightDate

Eine SYSTEMTIME-Struktur , die ein Datum und eine Ortszeit enthält, wenn der Übergang von der Standardzeit zur Sommerzeit unter diesem Betriebssystem stattfindet. Wenn die Zeitzone keine Sommerzeit unterstützt oder der Anrufer die Sommerzeit deaktivieren muss, muss der wMonth-Member in der SYSTEMTIME-Struktur 0 sein. Wenn dieses Datum angegeben wird, muss auch das StandardDate-Element in dieser Struktur angegeben werden.

Andernfalls geht das System davon aus, dass die Zeitzonendaten ungültig sind und keine Änderungen angewendet werden.

Wenn das wYear-Element nicht 0 ist, ist das Übergangsdatum absolut; Es tritt nur einmal auf. Andernfalls handelt es sich um ein relatives Datum, das jährlich auftritt.

DaylightBias

Der Biaswert, der während der Ortszeitübersetzungen verwendet werden soll, die während der Sommerzeit auftreten. Dieser Member wird ignoriert, wenn kein Wert für das DaylightDate-Element angegeben wird.

Dieser Wert wird dem Wert des Bias-Elements hinzugefügt, um die während der Sommerzeit verwendete Verzerrung zu bilden. In den meisten Zeitzonen ist der Wert dieses Members –60.

Hinweise

Die Einstellungen für jede Zeitzone werden im folgenden Registrierungsschlüssel gespeichert:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Windows NT
            CurrentVersion
               Time Zones
                  time_zone_name

Jeder Zeitzoneneintrag enthält die folgenden Registrierungswerte.

Registrierungswert	type	BESCHREIBUNG
Anzeige	REG_SZ	Neuer Anzeigename.
Dlt	REG_SZ	Die Beschreibung für die Tageslichtzeit.
MUI_Display	REG_SZ	Der Anzeigename als Zeichenfolge der Form @path,-stringID[;kommentar]. Weitere Informationen finden Sie unter MUI.
MUI_Dlt	REG_SZ	Die Beschreibung für die Tageslichtzeit als Zeichenfolge der Form @path,-stringID[;kommentar].
MUI_Std	REG_SZ	Die Beschreibung für die Standardzeit als Zeichenfolge der Form @path,-stringID[;kommentar].
Std	REG_SZ	Die Beschreibung für die Standardzeit.
TZI	REG_BINARY	Die folgenden Zeitzoneninformationen. `typedef struct _REG_TZI_FORMAT { LONG Bias; LONG StandardBias; LONG DaylightBias; SYSTEMTIME StandardDate; SYSTEMTIME DaylightDate; } REG_TZI_FORMAT;`

Weitere Informationen zum dynamischen DST-Schlüssel finden Sie unter DYNAMIC_TIME_ZONE_INFORMATION.

Sowohl StandardName als auch DaylightName werden gemäß der aktuellen Benutzerstandardsprache der Benutzeroberflächen lokalisiert.

Beispiele

Ein Beispiel finden Sie unter SetTimeZoneInformation.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Kopfzeile	timezoneapi.h (einschließlich Windows.h)

Weitere Informationen

DYNAMIC_TIME_ZONE_INFORMATION

GetTimeZoneInformation

SYSTEMTIME

SetTimeZoneInformation