Partager via


DateTime Structure

Définition

Représente un instant, généralement exprimé sous la forme d’une date ou d’une heure.

Javascript Ce type apparaît sous la forme de l’objet Date .

.NET Lors de la programmation avec .NET, ce type est masqué et les développeurs doivent utiliser la structure System.DateTimeOffset .

C++/CX Similaire à FILETIME , mais avec des différences importantes. Consultez la section Notes.

C++/WinRT Ce type est une spécialisation de std::chrono::time_point. Consultez la section Notes.

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
Héritage
DateTime
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (introduit dans v1.0)

Remarques

Les langages JavaScript et Microsoft .NET n’utilisent pas ce type directement. En JavaScript, un DateTime est projeté en tant qu’objet Date et dans Microsoft .NET, il est projeté en tant que System.DateTimeOffset. Chaque langue gère en toute transparence la conversion vers les plages de granularité et de dates pour la langue respective.

Dans les extensions de composant Visual C++ (C++/CX), une valeur DateTime.UniversalTime a la même granularité qu’une valeur FILETIME (intervalles de 100 nanosecondes). Pour les valeurs positives, une valeur DateTime.UniversalTime est identique à une valeur FILETIME , bien qu’elle ne puisse représenter que des dates jusqu’à environ 29 000 C.E. Une valeur négative représente le nombre d’intervalles antérieurs au 1er janvier 1601 et peut représenter des dates remontant à environ 27 400 avant notre ère. Pour le calendrier grégorien, vous pouvez utiliser un DateTimeFormatter pour créer des représentations sous forme de chaîne d’un DateTime pour les dates postérieures à minuit l’année 1 C.E.

Pour convertir universalTime en SYSTEMTIME, utilisez ULARGE_INTEGER pour convertir la valeur int64 enFILETIME, puis utilisez FileTimeToSystemTime pour obtenir SYSTEMTIME.

En C++/WinRT, DateTime est similaire à C++/CX en ce qu’il a la même granularité qu’un FILETIME. Contrairement à C++/CX, il s’agit d’une spécialisation de std::chrono::time_point plutôt que d’un struct distinct. C++/WinRT fournit des fonctions d’assistance pour convertir DateTime vers et depuis FILETIME et vers et depuis time_t. Pour plus d’informations sur ces fonctions, consultez winrt::clock struct.

Champs

UniversalTime

Entier signé 64 bits qui représente un point dans le temps comme le nombre d’intervalles de 100 nanosecondes avant ou après minuit le 1er janvier 1601 (selon le calendrier grégorien).

Notes

En C++/WinRT, ce champ n’existe pas, car dans cette projection de langage DateTime est une spécialisation de std::chrono::time_point. Si vous avez besoin de la valeur entière brute, utilisez time_point::time_since_epoch pour obtenir une valeur std::chrono::d uration et utilisez sa méthode count pour obtenir le nombre brut.

S’applique à

Voir aussi