DateTimeOffset.UtcDateTime Egenskap

Definition

Hämtar ett DateTime värde som representerar utc-datum och tid (Coordinated Universal Time) för det aktuella DateTimeOffset objektet.

public:
 property DateTime UtcDateTime { DateTime get(); };
public DateTime UtcDateTime { get; }
member this.UtcDateTime : DateTime
Public ReadOnly Property UtcDateTime As DateTime

Egenskapsvärde

UtC-datum och tid (Coordinated Universal Time) för det aktuella DateTimeOffset objektet.

Exempel

I följande exempel visas hur du använder UtcDateTime egenskapen för att visa ett DateTimeOffset värde och motsvarande UTC-tid.

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

Kommentarer

Egenskapen UtcDateTime utför en dubbel konvertering:

  • Det konverterar datum och tid för det aktuella DateTimeOffset objektet till Coordinated Universal Time (UTC). Konverteringen utförs genom att subtrahera värdet Offset för egenskapen från datum och tid för det aktuella DateTimeOffset objektet.

  • Värdet konverteras DateTimeOffset till ett DateTime värde.

Egenskapen Kind för det returnerade DateTime värdet är inställd på DateTimeKind.Utc.

Att hämta värdet för UtcDateTime egenskapen motsvarar att anropa det aktuella DateTimeOffset objektets ToUniversalTime.DateTime egenskap, förutom att Kind egenskapen för det senare DateTime värdet är DateTimeKind.Unspecified.

Gäller för