DateTimeOffset.UtcDateTime Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém um DateTime valor que representa a data e hora do Tempo Universal Coordenado (UTC) do objeto atual DateTimeOffset .
public:
property DateTime UtcDateTime { DateTime get(); };public DateTime UtcDateTime { get; }member this.UtcDateTime : DateTimePublic ReadOnly Property UtcDateTime As DateTimeValor de Propriedade
A data e hora do Tempo Universal Coordenado (UTC) do objeto atual DateTimeOffset .
Exemplos
O exemplo seguinte mostra como usar a UtcDateTime propriedade para mostrar um DateTimeOffset valor e o respetivo tempo UTC.
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
Observações
A UtcDateTime propriedade realiza uma conversão dual:
Converte a data e hora do objeto atual DateTimeOffset para Tempo Universal Coordenado (UTC). A conversão é realizada subtraindo o valor da Offset propriedade à data e hora do objeto atual DateTimeOffset .
Converte o DateTimeOffset valor num DateTime valor.
A Kind propriedade do valor devolvido 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 deste último DateTime valor é DateTimeKind.Unspecified.