Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Wandelt die angegebene Ortszeit in die entsprechende Zeit in koordinierte Weltzeit (UTC) um.
Syntax
BOOL TzSpecificLocalTimeToSystemTime(
[in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
[in] const SYSTEMTIME *lpLocalTime,
[out] LPSYSTEMTIME lpUniversalTime
);
Die Parameter
[in, optional] lpTimeZoneInformation
Ein Zeiger auf eine TIME_ZONE_INFORMATION-Struktur , die die Zeitzone für die in lpLocalTime angegebene Zeit angibt.
Wenn lpTimeZoneInformationNULL ist, verwendet die Funktion die aktuell aktive Zeitzone.
[in] lpLocalTime
Ein Zeiger auf eine SYSTEMTIME-Struktur , die die zu konvertierende lokale Zeit angibt. Diese Zeit wird von der Funktion in die entsprechende UTC-Zeit konvertiert.
[out] lpUniversalTime
Ein Zeiger auf eine SYSTEMTIME-Struktur , die die UTC-Zeit empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null, und die Funktion legt die Member der SYSTEMTIME-Struktur fest, auf die von lpUniversalTime auf die entsprechenden Werte verwiesen wird.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
TzSpecificLocalTimeToSystemTime berücksichtigt, ob Sommerzeit (DST) für die zu konvertierende Ortszeit wirksam ist.
Von Bedeutung
Die folgenden lokalen Zeiten, in der Nähe von DST-Übergängen, können mehrdeutig oder ungültig sein und zu unerwartetem Verhalten führen (da kein garantiertes "richtiges" Ergebnis vorhanden ist).
- Während des Übergangs von Sommerzeit zu Standardzeit wiederholt sich die lokale Uhr. Eine ortsübliche Zeit innerhalb des wiederholten Fensters ist mehrdeutig , da sie zweimal auftritt, einmal im Sommer und einmal in der Standardzeit.
- Während des Übergangs von Standardzeit zu Sommerzeit springt die lokale Uhr vorwärts. Eine ortsinterne Zeit innerhalb des übersprungenen Fensters ist ungültig , da keine gültige UTC-Konvertierung vorhanden ist.
Wenn die angegebene Ortszeit entweder mehrdeutig oder ungültig ist, behandelt die Funktion sie als Sommerzeit und wendet die Sommerzeitabweichung an. Anwendungen, die Kontinuität oder Genauigkeit erfordern, sollten diese Funktion vermeiden und stattdessen UTC-Zeit verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows XP [Desktop-Apps | UWP-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Fenster |
| Header | timezoneapi.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |