Classe de COleDateTime

Article
03/26/2013

Encapsule le type de données d' DATE utilisé dans OLE automation.

class COleDateTime

Membres

Constructeurs publics

Nom	Description
COleDateTime::COleDateTime	Construit un objet COleDateTime.

Méthodes publiques

Nom	Description
COleDateTime::Format	Génère une représentation sous forme de chaîne mise en forme d'un objet d' COleDateTime .
COleDateTime::GetAsDBTIMESTAMP	Appelez cette méthode pour obtenir l'heure de l'objet d' COleDateTime une structure de données de DBTIMESTAMP .
COleDateTime::GetAsSystemTime	Appelez cette méthode pour obtenir l'heure de l'objet d' COleDateTime une structure de données de SYSTEMTIME .
COleDateTime::GetAsUDATE	Appelez cette méthode pour obtenir l'heure dans COleDateTime une structure de données d' UDATE .
COleDateTime::GetCurrentTime	Crée un objet d' COleDateTime qui représente l'heure actuelle (fonction membre statique).
COleDateTime::GetDay	Retourne le jour dans lequel cet objet d' COleDateTime représente (1 à 31).
COleDateTime::GetDayOfWeek	Retourne le jour de la semaine dans lequel cet objet d' COleDateTime représente (dimanche = 1).
COleDateTime::GetDayOfYear	Retourne le jour de l'année où cet objet d' COleDateTime représente (1er janvier = 1).
COleDateTime::GetHour	Retourne l'heure de cet objet d' COleDateTime représente (0 à 23).
COleDateTime::GetMinute	Retourne la minute où cet objet d' COleDateTime représente (0 à 59).
COleDateTime::GetMonth	Retourne le mois dans lequel cet objet d' COleDateTime représente (1 à 12).
COleDateTime::GetSecond	Retourne le deuxième cet objet d' COleDateTime représente (0 à 59).
COleDateTime::GetStatus	Obtient l'état (validité) de cet objet d' COleDateTime .
COleDateTime::GetYear	Retourne l'année où cet objet d' COleDateTime représente.
COleDateTime::ParseDateTime	Lit une valeur de date/heure d'une chaîne et définit la valeur d' COleDateTime.
COleDateTime::SetDate	Définit la valeur de cet objet d' COleDateTime à la valeur réservée à la date.
COleDateTime::SetDateTime	Définit la valeur de cet objet d' COleDateTime au valeur de date/d'heure spécifié.
COleDateTime::SetStatus	Définit l'état (validité) de cet objet d' COleDateTime .
COleDateTime::SetTime	Définit la valeur de cet objet d' COleDateTime à la valeur réservée à la fois spécifiée.

Opérateurs publics

Nom	Description
== De COleDateTime::operator, COleDateTime::operator <, etc..	Compare deux valeurs d' COleDateTime .
COleDateTime::operator +, - COleDateTime::operator	Ajoutez et soustrayez les valeurs d' COleDateTime .
COleDateTime::operator +=, COleDateTime::operator - =	Ajoutez et soustraire une valeur d' COleDateTime de cet objet d' COleDateTime .
COleDateTime::operator =	Copie une valeur d' COleDateTime .
DATE de COleDateTime::operator, COleDateTime::operator Date*	Convertit une valeur d' COleDateTime dans DATE ou DATE*.

Données membres publiques

Nom	Description
COleDateTime::m_dt	Contient DATE sous-jacent pour cet objet d' COleDateTime .
COleDateTime::m_status	Contient l'état de cet objet d' COleDateTime .

Notes

COleDateTime n'a pas de classe de base.

Elle est l'un des types possibles pour le type de données Variant OLE automation de.Une valeur d' COleDateTime représente une valeur absolue de date et d'heure.

Le type d' DATE est implémenté comme une valeur à virgule flottante.Les jours sont mesurés depuis le 30 décembre 1899, à minuit.Le tableau suivant présente des dates et leurs valeurs associées :

Date	Valeur
29 décembre 1899, Minuit	-1.0
29 décembre 1899, 6 Du matin	-1.25
30 décembre 1899, Minuit	0.0
31 décembre 1899, Minuit	1.0
1er janvier 1900, 6h du matin..	2.25

Attention
Remarque dans le tableau au-dessus de ce même si les valeurs du jour sont négatives avant minuit le 30 décembre 1899, les valeurs d'heure ne stocke pas.Par exemple, le 6h00 du matin est toujours représenté par une valeur fractionnaire 0,25 que l'entier représentant le niveau est positif (après le 30 décembre 1899) ou négatif (avant le 30 décembre 1899).Cela signifie qu'une comparaison simple de virgule flottante trierait à tort COleDateTime représentant le 6h00 du matin sur 12/29/1899 comme later qu'un 7h00 du matin de performances le même niveau.

Remarque dans le tableau au-dessus de ce même si les valeurs du jour sont négatives avant minuit le 30 décembre 1899, les valeurs d'heure ne stocke pas.Par exemple, le 6h00 du matin est toujours représenté par une valeur fractionnaire 0,25 que l'entier représentant le niveau est positif (après le 30 décembre 1899) ou négatif (avant le 30 décembre 1899).Cela signifie qu'une comparaison simple de virgule flottante trierait à tort COleDateTime représentant le 6h00 du matin sur 12/29/1899 comme later qu'un 7h00 du matin de performances le même niveau.

La classe d' COleDateTime gère des dates, depuis le 1er janvier 100, jusqu'au 31 décembre, 9999.La classe d' COleDateTime utilise le calendrier grégorien ; elle ne prend pas en charge les dates julien.COleDateTime ignore l'heure d'été.(Consultez date et heure : Prise en charge d'automation.)

[!REMARQUE]

Vous pouvez utiliser le format d' %y pour récupérer une année sur deux chiffres uniquement pour les dates commençant par 1900.Si vous utilisez le format d' %y une date avant 1900, le code génère une erreur ASSERT.

Ce type est également utilisé pour représenter des valeurs réservées à la date ou uniquement à la fois.Par convention, la date 0 (30 décembre 1899) est utilisée pour les valeurs réservées à la fois et le 0h00 de temps (minuit) est utilisée pour les valeurs réservées à la date.

Si vous créez un objet d' COleDateTime en utilisant une date moins de 100, la date est reçue, mais les appels suivants à GetYear, GetMonth, GetDay, GetHour, GetMinute, et l'échec et retourner -1 d' GetSecond .Précédemment, vous pouvez utiliser les dates à deux chiffres, mais les dates soient 100 ou plus importantes dans MFC 4,2 et versions ultérieures.

Pour éviter les problèmes, spécifiez une date à quatre chiffres.Par exemple :

COleDateTime mytime(1996, 1, 1, 0, 0, 0);

Les opérations arithmétiques de base pour les valeurs d' COleDateTime utilisent la classe COleDateTimeSpanauxiliaires.Les valeurs d'COleDateTimeSpan définissent un intervalle de temps.La relation entre ces classes est similaire à celle entre CTime et CTimeSpan.

Pour plus d'informations sur les classes d' COleDateTime et d' COleDateTimeSpan , consultez l'article date et heure : Prise en charge d'automation.