DateTimeOffset.UtcDateTime Eigenschaft
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.
Ruft einen DateTime Wert ab, der das Datum und die Uhrzeit der koordinierten Weltzeit (Coordinated Universal Time, UTC) des aktuellen DateTimeOffset Objekts darstellt.
public:
property DateTime UtcDateTime { DateTime get(); };public DateTime UtcDateTime { get; }member this.UtcDateTime : DateTimePublic ReadOnly Property UtcDateTime As DateTimeEigenschaftswert
Datum und Uhrzeit der koordinierten Weltzeit (Coordinated Universal Time, UTC) des aktuellen DateTimeOffset Objekts.
Beispiele
Im folgenden Beispiel wird gezeigt, wie Sie mithilfe der UtcDateTime Eigenschaft einen DateTimeOffset Wert und die entsprechende UTC-Zeit anzeigen.
DateTimeOffset offsetTime = new DateTimeOffset(2007, 11, 25, 11, 14, 00,
new TimeSpan(3, 0, 0));
Console.WriteLine("{0} is equivalent to {1} {2}",
offsetTime.ToString(),
offsetTime.UtcDateTime.ToString(),
offsetTime.UtcDateTime.Kind.ToString());
// The example displays the following output:
// 11/25/2007 11:14:00 AM +03:00 is equivalent to 11/25/2007 8:14:00 AM Utc
let offsetTime = DateTimeOffset(2007, 11, 25, 11, 14, 00, TimeSpan(3, 0, 0))
printfn $"{offsetTime} is equivalent to {offsetTime.UtcDateTime} {offsetTime.UtcDateTime.Kind}"
// The example displays the following output:
// 11/25/2007 11:14:00 AM +03:00 is equivalent to 11/25/2007 8:14:00 AM Utc
Dim offsetTime As New DateTimeOffset(#11/25/2007 11:14AM#, _
New TimeSpan(3, 0, 0))
Console.WriteLine("{0} is equivalent to {1} {2}", _
offsetTime.ToString(), _
offsetTime.UtcDateTime.ToString(), _
offsetTime.UtcDateTime.Kind.ToString())
' The example displays the following output:
' 11/25/2007 11:14:00 AM +03:00 is equivalent to 11/25/2007 8:14:00 AM Utc
Hinweise
Die UtcDateTime Eigenschaft führt eine duale Konvertierung aus:
Es konvertiert das Datum und die Uhrzeit des aktuellen DateTimeOffset Objekts in koordinierte Weltzeit (UTC). Die Konvertierung wird ausgeführt, indem der Wert der Offset Eigenschaft vom Datum und der Uhrzeit des aktuellen DateTimeOffset Objekts subtrahiert wird.
Er konvertiert den DateTimeOffset Wert in einen DateTime Wert.
Die Kind Eigenschaft des zurückgegebenen DateTime Werts wird auf DateTimeKind.Utc.
Das Abrufen des Werts der UtcDateTime Eigenschaft entspricht dem Aufrufen der Eigenschaft des ToUniversalTime.DateTime aktuellen DateTimeOffset Objekts, mit der Ausnahme, dass die Kind Eigenschaft des letzteren DateTime Werts istDateTimeKind.Unspecified.
