Freigeben über


DateTimeOffset.UtcDateTime Eigenschaft

Definition

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