DateTime Estrutura
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 DateTimeOffsetvar 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. |