CTime::CTime

Article
03/04/2013

Crée un nouvel objet d' CTime initialisé avec le temps spécifié.

CTime( ) throw( );
CTime(
   __time64_t time 
) throw( );
CTime(
   int nYear,
   int nMonth,
   int nDay,
   int nHour,
   int nMin,
   int nSec,
   int nDST = -1 
);
CTime(
   WORD wDosDate,
   WORD wDosTime,
   int nDST = -1 
);
CTime(
   const SYSTEMTIME& st,
   int nDST = - 1 
) throw( );
CTime(
   const FILETIME& ft,
   int nDST = - 1 
);
CTime(
   const DBTIMESTAMP& dbts,
   int nDST = -1
) throw( );

Paramètres

timeSrc
Indique un objet d' CTime existant.
time
Une valeur de temps de __time64_t , qui est le nombre de secondes écoulées après le 1er janvier 1970 UTC.Notez que cela est défini à l'heure locale.Par exemple, si vous êtes à New York et créez un objet d' CTime en passant un paramètre de 0, CTime::GetMonth retourne 12.

Dans les versions de Visual C++ 6,0 et versions antérieures, time a une valeur d' time_t.Visual C++ .NET et de derniers convertit un paramètre d' time_t à __time64_t.
nYear, nMonth, nDay, nHour, nMin, nSec
Indique les valeurs de date et d'heure à copier dans le nouvel objet d' CTime .
nDST
Indique si l'heure d'été est appliquée.Peut avoir l'une des trois valeurs suivantes :
- nDST a la valeur 0 heure d'hiver est appliquée.
- nDST affectez une valeur supérieure à 0 heures d'été sont appliquées.
- nDST affectez à une valeur inférieure à 0 est la valeur par défaut.Calcule automatiquement si l'heure d'hiver ou l'heure d'été est appliquée.
wDosDate, wDosTime
Valeurs de date et heure de commande MS-DOS à convertir en valeur de date/d'heure et copiées nouvel CTime l'objet.
st
Une structure de SYSTEMTIME à convertir en valeur de date/d'heure et copiée dans nouvel CTime l'objet.
ft
Une structure de FILETIME à convertir en valeur de date/d'heure et copiée dans nouvel CTime l'objet.
dbts
Une référence à une structure d' DBTimeStamp contenant l'heure locale actuelle.

Notes

Chaque constructeur est décrit ci-dessous :

CTime( ); construit un objet non initialisé d' CTime .Ce constructeur permet de définir des tableaux d'objets d' CTime .Vous devez initialiser de ces tableaux avec des heures valides avant utilisation.
CTime( const CTime& ); construit un objet d' CTime d'une autre valeur d' CTime .
CTime( __time64_t ); construit un objet d' CTime d'un type de __time64_t .Ce constructeur attend une heure UTC et convertit le résultat à une heure locale avant d'enregistrer le résultat.
Éléments deCTime( int, int,…); un objet d' CTime des composants heure locale à chaque composant limité aux intervalles suivants :

Composant

Plage

nYear

1970–3000

nMonth

1–12

nDay

1–31

nHour

0-23

nMin

0-59

nSec

0-59

Ce constructeur effectue la conversion appropriée à l'heure UTC.La version debug des assertions de bibliothèque MFC si un ou plusieurs composants d'heure sont hors limites.Vous devez valider les arguments avant d'appeler.Ce constructeur attend une heure locale.
CTime( WORD, WORD ); construit un objet d' CTime les valeurs spécifiées de date et heure de commande MS-DOS.Ce constructeur attend une heure locale.
CTime( const SYSTEMTIME& ); construit un objet d' CTime d'une structure d' SYSTEMTIME .Ce constructeur attend une heure locale.
CTime( const FILETIME& ); construit un objet d' CTime d'une structure d' FILETIME .Vous n'utiliserez probablement pas l'initialisation d' CTimeFILETIME directement.Si vous utilisez un objet d' CFile pour manipuler un fichier, CFile::GetStatus récupère le groupe date/heure heure du fichier pour vous à un objet d' CTime initialisé avec une structure d' FILETIME .Ce constructeur suppose un moment selon l'heure UTC et convertit automatiquement la valeur en heure locale avant d'enregistrer le résultat.

[!REMARQUE]

Le constructeur à l'aide de le paramètre de DBTIMESTAMP est uniquement disponible lorsque OLEDB.h est inclus.

Composant	Plage
nYear	1970–3000
nMonth	1–12
nDay	1–31
nHour	0-23
nMin	0-59
nSec	0-59

Pour plus d'informations, consultez la structure de SYSTEMTIME et de FILETIME dans Kit de développement logiciel Windows.Consultez également l'entrée de Date et heure de commande MS-DOS dans Kit de développement logiciel Windows.

Exemple

time_t osBinaryTime;  // C run-time time (defined in <time.h>)
time(&osBinaryTime) ;  // Get the current time from the 
                         // operating system.
CTime time1; // Empty CTime. (0 is illegal time value.)
CTime time2 = time1; // Copy constructor.
CTime time3(osBinaryTime);  // CTime from C run-time time
CTime time4(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999