TIME_ZONE_INFORMATION-Struktur (timezoneapi.h)
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.
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).
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.
|
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) |