DateTimeOffset.UtcDateTime Proprietà

Definizione

Ottiene un valore DateTime che rappresenta la data e l'ora UTC (Coordinated Universal Time) dell'oggetto DateTimeOffset corrente.

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

Valore della proprietà

DateTime

Data e ora UTC (Coordinated Universal Time) dell'oggetto DateTimeOffset corrente.

Esempio

Nell'esempio seguente viene illustrato come utilizzare la UtcDateTime proprietà per visualizzare un valore e DateTimeOffset l'ora UTC corrispondente.

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
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

Commenti

La UtcDateTime proprietà esegue una doppia conversione:

  • Converte la data e l'ora dell'oggetto corrente in DateTimeOffset Coordinated Universal Time (UTC). La conversione viene eseguita sottraendo il valore della Offset proprietà dalla data e dall'ora dell'oggetto DateTimeOffset corrente.

  • Converte il DateTimeOffset valore in un valore DateTime .

La Kind proprietà del valore DateTime restituito è impostata su DateTimeKind.Utc .

Il recupero del valore della proprietà equivale a chiamare la proprietà dell'oggetto corrente, ad eccezione del fatto che la proprietà UtcDateTime DateTimeOffset ToUniversalTime.DateTime dell'ultimo valore è Kind DateTime DateTimeKind.Unspecified .

Si applica a