DateTimeOffset.UtcDateTime Eigenschaft

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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 die UTC (Coordinated Universal Time)-Datums- und Uhrzeitangabe des aktuellen DateTimeOffset-Objekts darstellt.

public:
 property DateTime UtcDateTime { DateTime get(); };

public DateTime UtcDateTime { get; }

member this.UtcDateTime : DateTime

Public ReadOnly Property UtcDateTime As DateTime

Eigenschaftswert

DateTime

Die UTC (Coordinated Universal Time)-Datums- und Uhrzeitangabe des aktuellen DateTimeOffset-Objekts.

Beispiele

Das folgende Beispiel zeigt, wie Sie mithilfe der UtcDateTime Eigenschaft einen DateTimeOffset Wert und die entsprechende UTC-Uhrzeit 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 Werts DateTime wird auf DateTimeKind.Utc.

Das Abrufen des Werts der UtcDateTime Eigenschaft entspricht dem Aufrufen der Eigenschaft des aktuellen DateTimeOffset Objekts ToUniversalTime.DateTime , außer dass die Kind Eigenschaft des letzten DateTime Werts ist DateTimeKind.Unspecified.

Gilt für

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Freigeben über