TimeZone.ToUniversalTime(DateTime) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Coordinated Universal Time (UTC) zurück, die einer angegebenen Zeit entspricht.
public:
virtual DateTime ToUniversalTime(DateTime time);
public virtual DateTime ToUniversalTime (DateTime time);
abstract member ToUniversalTime : DateTime -> DateTime
override this.ToUniversalTime : DateTime -> DateTime
Public Overridable Function ToUniversalTime (time As DateTime) As DateTime
Parameter
- time
- DateTime
Ein Datum und eine Uhrzeit.
Gibt zurück
Ein DateTime-Objekt, dessen Wert die time
entsprechende Coordinated Universal Time (UTC) ist.
Hinweise
Wenn die lokale Zeitzone die Sommerzeit beobachtet, wendet die aktuelle Anpassungsregel auf den time
Parameter an, ToUniversalTime wenn die Konvertierung ausgeführt wird.
Hinweis
Die ToUniversalTime Methode erkennt nur die aktuelle Sommerzeitanpassungsregel für die lokale Zeitzone. Daher wird garantiert, dass die koordinierte Weltzeit (UTC) genau zurückgegeben wird, die nur während des Zeitraums entspricht, in dem die neueste Anpassungsregel wirksam ist. Es kann ungenaue Ergebnisse zurückgeben, wenn time
es sich um einen historischen Datums- und Uhrzeitwert handelt, der einer vorherigen Anpassungsregel unterliegt.
Wenn der time
Parameter eine mehrdeutige Zeit ist, geht die Methode davon aus, dass es sich um eine Standardzeit handelt. (Eine mehrdeutige Zeit ist eine, die entweder einer Standardzeit oder einer Sommerzeit in der lokalen Zeitzone zugeordnet werden kann.) Wenn time
es sich um eine ungültige Uhrzeit handelt, subtrahiert die Methode einfach die Ortszeit vom UTC-Offset der lokalen Zeitzone, um UTC zurückzugeben. (Eine ungültige Zeit ist eine, die aufgrund der Anwendung von Sommerzeitanpassungsregeln nicht vorhanden ist.)
Da time
in Bezug auf die aktuelle Zeitzone des aktuellen Systems interpretiert wird, kann sich das datum und die von dieser Methode zurückgegebene Uhrzeit unterscheiden, wenn eine Anwendung auf verschiedenen Computern oder auf demselben Computer mit unterschiedlichen Zeitzonen ausgeführt wird. Bei Fällen, in denen ein Datums- und Uhrzeitwert einen einzelnen, eindeutigen Zeitpunkt darstellen muss, verwenden Sie einen DateTimeOffset Wert, um die lokale Uhrzeit darzustellen.
Die ToUniversalTime Methode entspricht der TimeZoneInfo.ConvertTimeToUtc(DateTime) Methodenüberladung mit einem DateTime Parameter, dessen Kind Eigenschaft nicht gleich DateTimeKind.Utcist. Verwenden Sie nach Möglichkeit die TimeZoneInfo.ConvertTimeToUtc(DateTime) Methodenüberladung.