DateTimeOffset.UtcDateTime Propriedade

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

DateTimeOffset.cs

Obtém um valor DateTime que representa da data e hora UTC (Tempo Universal Coordenado) do objeto DateTimeOffset atual.

public:
 property DateTime UtcDateTime { DateTime get(); };

public DateTime UtcDateTime { get; }

member this.UtcDateTime : DateTime

Public ReadOnly Property UtcDateTime As DateTime

Valor da propriedade

DateTime

A data e hora UTC (Tempo Universal Coordenado) do objeto DateTimeOffset atual.

Exemplos

O exemplo a seguir mostra como usar a UtcDateTime propriedade para exibir um DateTimeOffset valor e sua hora UTC correspondente.

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

Comentários

A UtcDateTime propriedade executa uma conversão dupla:

• Ele converte a data e a hora do objeto atual DateTimeOffset em UTC (Tempo Universal Coordenado). A conversão é executada subtraindo o valor da Offset propriedade da data e hora do objeto atual DateTimeOffset .

• Ele converte o DateTimeOffset valor em um DateTime valor .

A Kind propriedade do valor retornado DateTime é definida como DateTimeKind.Utc.

Recuperar o valor da UtcDateTime propriedade é equivalente a chamar a propriedade do ToUniversalTime.DateTime objeto atualDateTimeOffset, exceto que a Kind propriedade do último DateTime valor é DateTimeKind.Unspecified.