DateTime Struct

Definizione

Spazio dei nomi:

Windows.Foundation

Rappresenta un istante di tempo, in genere espresso come data e ora del giorno.

Javascript Questo tipo viene visualizzato come oggetto Date .

.NET Quando si esegue la programmazione con .NET, questo tipo è nascosto e gli sviluppatori devono usare la struttura System.DateTimeOffset .

C++/CX Simile a FILETIME , ma con differenze importanti. Vedere la sezione Osservazioni.

C++/WinRT Questo tipo è una specializzazione di std::chrono::time_point. Vedere la sezione Osservazioni.

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

Ereditarietà

ValueType

DateTime

Attributi

ContractVersionAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (è stato introdotto in v1.0)

Commenti

I linguaggi JavaScript e Microsoft .NET non usano direttamente questo tipo. In JavaScript un oggetto DateTime viene proiettato come oggetto Date e in Microsoft .NET viene proiettato come System.DateTimeOffset. Ogni lingua gestisce in modo trasparente la conversione negli intervalli di granularità e data per la rispettiva lingua.

Nelle estensioni dei componenti di Visual C++ (C++/CX), un valore DateTime.UniversalTime ha la stessa granularità di un fileTIME (intervalli a 100 nanosecondi). Per i valori positivi, un valore DateTime.UniversalTime è identico a un valore FILETIME , anche se può rappresentare solo date fino a circa 29000 C.E. Un valore negativo rappresenta il numero di intervalli precedenti al 1° gennaio 1601 e può rappresentare le date di circa 27.400 B.C.E. Per il calendario gregoriano, è possibile usare DateTimeFormatter per creare rappresentazioni di stringa di un oggetto DateTime per le date dopo mezzanotte dell'anno 1 C.E.

Per convertire UniversalTime in SYSTEMTIME, usare ULARGE_INTEGER per convertire il valore int64 in FILETIME, quindi usare FileTimeToSystemTime per ottenere SYSTEMTIME.

In C++/WinRT DateTime è simile a C++/CX in cui ha la stessa granularità di FILETIME. A differenza di C++/CX, è una specializzazione di std::chrono::time_point anziché uno struct distinto. C++/WinRT offre funzioni helper per convertire DateTime in e da FILETIME e da e verso e da time_t. Per altre informazioni su queste funzioni, vedere struct winrt::clock.

Campi

UniversalTime

Intero con segno a 64 bit che rappresenta un punto nel tempo come numero di intervalli di 100 nanosecondi prima o dopo la mezzanotte del 1° gennaio 1601 (secondo il calendario gregoriano). Nota In C++/WinRT questo campo non esiste, perché in tale proiezione del linguaggio DateTime è una specializzazione di std::chrono::time_point. Se è necessario il valore intero non elaborato, usare time_point::time_since_epoch per ottenere un valore std::chrono::d uration e usare il metodo count per ottenere il conteggio non elaborato.

Vedi anche

• System.DateTimeOffset
• Oggetto Date
• FILETIME
• Esempio di calendario (Windows 10)