Partilhar via


DateTime Estrutura

Definição

Representa um momento no tempo, geralmente expresso como uma data e hora do dia.

Javascript Esse tipo aparece como o objeto Date .

.NET Ao programar com o .NET, esse tipo fica oculto e os desenvolvedores devem usar a estrutura System.DateTimeOffset .

C++/CX Semelhante a FILETIME , mas com diferenças importantes. Consulte Observações.

C++/WinRT Esse tipo é uma especialização de std::chrono::time_point. Consulte Observações.

public value class DateTime
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
struct time_point
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
public struct DateTimeOffset
var dateTime = {
universalTime : /* Your value */
}
Public Structure DateTimeOffset
Herança
DateTime
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (introduzida na v1.0)

Comentários

Os idiomas JavaScript e Microsoft .NET não usam esse tipo diretamente. Em JavaScript, um DateTime é projetado como um objeto Date e, no Microsoft .NET, ele é projetado como um System.DateTimeOffset. Cada idioma manipula de forma transparente a conversão para os intervalos de granularidade e data para o respectivo idioma.

Em extensões de componente do Visual C++ (C++/CX), um valor DateTime.UniversalTime tem a mesma granularidade que um FILETIME (intervalos de 100 nanossegundos). Para valores positivos, um valor DateTime.UniversalTime é idêntico a um valor FILETIME , embora só possa representar datas até cerca de 29000 C.E. Um valor negativo representa o número de intervalos antes de 1º de janeiro de 1601 e pode representar datas de cerca de 27.400 A.C.E. Para o Calendário Gregoriano, você pode usar um DateTimeFormatter para criar representações de cadeia de caracteres de um DateTime para datas após a meia-noite do 1º ano.

Para converter o UniversalTime em SYSTEMTIME, use ULARGE_INTEGER para converter o valor int64 emFILETIME e, em seguida, use FileTimeToSystemTime para obter SYSTEMTIME.

No C++/WinRT, DateTime é semelhante ao C++/CX, pois tem a mesma granularidade que um FILETIME. Ao contrário do C++/CX, é uma especialização de std::chrono::time_point em vez de um struct distinto. O C++/WinRT fornece funções auxiliares para converter DateTime de e para FILETIME e de e para time_t. Para obter mais informações sobre essas funções, consulte winrt::clock struct.

Campos

UniversalTime

Um inteiro com sinal de 64 bits que representa um ponto no tempo como o número de intervalos de 100 nanossegundos antes ou depois da meia-noite de 1º de janeiro de 1601 (de acordo com o Calendário Gregoriano).

Observação

No C++/WinRT, esse campo não existe, pois nessa projeção de linguagem DateTime é uma especialização de std::chrono::time_point. Se você precisar do valor inteiro bruto, use time_point::time_since_epoch para obter uma std::chrono::d uration e use seu método count para obter a contagem bruta.

Aplica-se a

Confira também