DateTimeOffset.UtcDateTime DateTimeOffset.UtcDateTime DateTimeOffset.UtcDateTime DateTimeOffset.UtcDateTime Property

Definizione

Ottiene un valore DateTime che rappresenta la data e l'ora UTC (Coordinated Universal Time) dell'oggetto DateTimeOffset corrente.Gets a DateTime value that represents the Coordinated Universal Time (UTC) date and time of the current DateTimeOffset object.

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

Valore della proprietà

Data e ora UTC (Coordinated Universal Time) dell'oggetto DateTimeOffset corrente.The Coordinated Universal Time (UTC) date and time of the current DateTimeOffset object.

Esempi

Nell'esempio seguente viene illustrato come utilizzare la UtcDateTime proprietà per visualizzare un DateTimeOffset valore e l'ora UTC corrispondente.The following example shows how to use of the UtcDateTime property to display a DateTimeOffset value and its corresponding UTC time.

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:The UtcDateTime property performs a dual conversion:

  • Converte la data e l'ora dell'oggetto corrente DateTimeOffset nell'ora UTC (Coordinated Universal Time).It converts the date and time of the current DateTimeOffset object to Coordinated Universal Time (UTC). La conversione viene eseguita sottraendo il valore della Offset proprietà dalla data e dall'ora dell'oggetto corrente. DateTimeOffsetThe conversion is performed by subtracting the value of the Offset property from the date and time of the current DateTimeOffset object.

  • Il DateTimeOffset valore viene convertito in un DateTime valore.It converts the DateTimeOffset value to a DateTime value.

La Kind proprietà del valore restituito DateTime è impostata su DateTimeKind.Utc.The Kind property of the returned DateTime value is set to DateTimeKind.Utc.

Il recupero del UtcDateTime valore della proprietà equivale alla chiamata della ToUniversalTime.DateTime proprietà dell'oggetto DateTimeOffset corrente, ad eccezione del fatto che Kind la proprietà del secondo DateTime valore è DateTimeKind.Unspecified.Retrieving the value of the UtcDateTime property is equivalent to calling the current DateTimeOffset object's ToUniversalTime.DateTime property, except that the Kind property of the latter DateTime value is DateTimeKind.Unspecified.

Si applica a