Nyelv

DateTimeOffset.UtcDateTime Tulajdonság

Definíció

DateTime Olyan értéket kap, amely az aktuális DateTimeOffset objektum koordinált egyetemes idejét (UTC) jelöli.

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

Tulajdonság értéke

Az aktuális DateTimeOffset objektum koordinált világidő (UTC) dátuma és ideje.

Példák

Az alábbi példa bemutatja, hogyan használható a UtcDateTime tulajdonság egy DateTimeOffset érték és a hozzá tartozó UTC idő megjelenítésére.

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

Megjegyzések

A UtcDateTime tulajdonság kettős átalakítást hajt végre:

  • Az aktuális DateTimeOffset objektum dátumát és idejét koordinált egyetemes idő (UTC)má alakítja. Az átalakítás úgy történik, hogy kivonja a Offset tulajdonság értékét az aktuális DateTimeOffset objektum dátumából és idejéből.

  • Az értéket értékké DateTimeOffset alakítjaDateTime.

A Kind visszaadott DateTime érték tulajdonsága a következőre DateTimeKind.Utcvan állítva: .

A tulajdonság értékének beolvasása UtcDateTime egyenértékű az aktuális DateTimeOffset objektum tulajdonságának meghívásávalToUniversalTime.DateTime, azzal a különbségel, hogy az Kind utóbbi DateTime érték tulajdonsága .DateTimeKind.Unspecified

A következőre érvényes: