Classe de CTime

Article
04/10/2013

Représente une date et une heure absolue.

class CTime

Membres

Constructeurs publics

Nom	Description
CTime::CTime	Construit des objets d' CTime de plusieurs façons.

Méthodes publiques

Nom	Description
CTime::Format	Convertit un objet d' CTime dans un basé sur une chaîne mise en forme du fuseau horaire local.
CTime::FormatGmt	Convertit un objet d' CTime dans un basé sur une chaîne mise en forme sur l'heure UTC.
CTime::GetAsDBTIMESTAMP	Convertit l'indication d'heure stockée dans l'objet d' CTime à une structure de Win32-compatible DBTimeStamp .
CTime::GetAsSystemTime	Convertit l'indication d'heure stockée dans l'objet d' CTime à une structure de Win32-compatible SYSTEMTIME .
CTime::GetCurrentTime	Crée un objet d' CTime qui représente l'heure actuelle (fonction membre statique).
CTime::GetDay	Retourne le jour représentent par l'objet d' CTime .
CTime::GetDayOfWeek	Retourne le jour de la semaine représentée par l'objet d' CTime .
CTime::GetGmtTm	Détaille un objet d' CTime en composants — en heure UTC.
CTime::GetHour	Retourne l'heure représentée par l'objet d' CTime .
CTime::GetLocalTm	Détaille un objet d' CTime en composants (selon le fuseau horaire local.
CTime::GetMinute	Retourne la minute représentée par l'objet d' CTime .
CTime::GetMonth	Retourne le mois représenté par l'objet d' CTime .
CTime::GetSecond	Retourne le deuxième représenté par l'objet d' CTime .
CTime::GetTime	Retourne une valeur de __time64_t pour l'objet donné d' CTime .
CTime::GetYear	Retourne l'année représentée par l'objet d' CTime .
CTime::Serialize64	Sérialise les données vers ou d'une archive.

Opérateurs

opérateur + )	Ces opérateurs d'ajout et soustraient CTimeSpan et les objets d' CTime .
opérateur +, – =	Ces opérateurs d'ajout et soustraient un objet d' CTimeSpan à partir de cet objet d' CTime .
opérateur =	l'opérateur d'assignation.
== d'opérateur, <, etc..	Opérateurs de comparaison.

Notes

CTime n'a pas de classe de base.

Les valeurs d'CTime ont lieu selon le temps universel coordonné (UTC), qui équivaut au temps universel (universal, universal time).Consultez Gestion de la durée pour plus d'informations sur la façon dont le fuseau horaire est déterminé.

Lorsque vous créez un objet d' CTime , affectez au paramètre d' nDST à 0 pour indiquer que l'heure d'hiver est appliquée, ou une valeur supérieure à 0 pour indiquer que l'heure d'été est appliquée, ou une valeur inférieure de zéro pour que le calcul de code de la bibliothèque Runtime C si l'heure d'hiver ou l'heure d'été est appliquée.tm_isdst est un champ obligatoire.Si sa valeur, sa valeur est non définie et la valeur de retour de mktime est imprévisible.Si les points d' timeptr à une structure de TM retourné par un appel précédent à asctime_s, à _gmtime_s, ou à localtime_s, le champ d' tm_isdst contient la valeur correcte.

Une classe auxiliaire, CTimeSpan, représente un intervalle de temps.

Les classes d' CTime et d' CTimeSpan ne sont pas conçus pour la dérivation.Étant donné qu'il n'y a aucune fonction virtuelle, la taille d' CTime et les objets d' CTimeSpan est exactement à 8 octets.La plupart des fonctions membres sont inline.

[!REMARQUE]

La date limite supérieure est 12/31/3000.La limite inférieure est 1/1/1970 12h00 : 0h du matin GMT.

Pour plus d'informations sur l'utilisation CTime, consultez les articles date et heure, et le Gestion de la durée dans la référence de la bibliothèque Runtime.

[!REMARQUE]

CTime MFC modifié par structure MFC 7,1 à 8,0.Si vous sérialisez une structure d' CTime à l'aide de operator << sous MFC 8,0 ou une version ultérieure, le fichier résultant n'est pas accessible en lecture sur les versions antérieures MFC.