Partager via


COleDateTime, classe

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

Avertissement

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.)

Notes

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.

Configuration requise

**en-tête :**ATLComTime.h

Voir aussi

Référence

COleVariant, classe

CTime, classe

CTimeSpan, classe

Graphique de la hiérarchie

Autres ressources

ATL/MFC étapes partagées des classes