COleDateTime::COleDateTime

Article
03/04/2013

Construit un objet COleDateTime.

COleDateTime( ) throw( ); 
COleDateTime(
   const VARIANT& varSrc 
) throw( );
COleDateTime(
   DATE dtSrc 
) throw( );
COleDateTime(
   time_t timeSrc 
) throw( );
COleDateTime(
   __time64_t timeSrc 
) throw( );
COleDateTime(
   const SYSTEMTIME& systimeSrc 
) throw( );
COleDateTime(
   const FILETIME& filetimeSrc 
) throw( );
COleDateTime(
   int nYear,
   int nMonth,
   int nDay,
   int nHour,
   int nMin,
   int nSec 
) throw( );
COleDateTime(
   WORD wDosDate,
   WORD wDosTime 
) throw( );
COleDateTime(
   const DBTIMESTAMP& dbts
) throw();

Paramètres

dateSrc
Un objet existant d' COleDateTime à copier dans le nouvel objet d' COleDateTime .
varSrc
Une structure de données existante de variant (éventuellement un objet d' COleVariant ) à convertir en valeur de date/d'heure (VT_DATE) et copiée dans nouvel COleDateTime l'objet.
dtSrc
Une valeur de date/heure (DATE) à copier dans le nouvel objet d' COleDateTime .
timeSrc
Une valeur d' time_t ou de __time64_t à convertir en valeur de date/d'heure et copiée dans nouvel COleDateTime l'objet.
systimeSrc
Une structure d' SYSTEMTIME à convertir en valeur de date/d'heure et copiée dans nouvel COleDateTime l'objet.
filetimeSrc
Une structure d' FILETIME à convertir en valeur de date/d'heure et copiée dans nouvel COleDateTime l'objet.Notez qu' FILETIME utilise le temps UTC (UTC), si vous passez une heure locale dans la structure, les résultats sont non valides.Consultez heures du fichier dans Kit de développement logiciel Windows pour plus d'informations.
nYear, nMonth, nDay, nHour, nMin, nSec
Indiquez les valeurs de date et d'heure à copier dans le nouvel objet d' COleDateTime .
wDosDate, wDosTime
Valeurs de date et heure de commande MS-DOS à convertir en valeur de date/d'heure et copiées nouvel COleDateTime l'objet.
dbts
Une référence à une structure d' DBTimeStamp contenant l'heure locale actuelle.

Notes

Tous ces constructeurs créent des objets d' COleDateTime initialisés à la valeur spécifiée.Le tableau suivant indique les plages valides pour chaque composant de date et d'heure :

Composant de date/heure	Plage valide
année	100 – 9999
mois	0 – 12
jour	0 – 31
heure	0 – 23
min	0 – 59
deuxièmement	0 – 59

Notez que la limite supérieure réelle du composant " jour varie en fonction de les composants de mois et d'année.Pour plus d'informations, consultez les fonctions membres de SetDate ou d' SetDateTime .

Une brève description de chaque constructeur :

Éléments d'COleDateTime() un objet d' COleDateTime initialisé à 0 (minuit, le 30 décembre 1899).
COleDateTime(dateSrc) construit un objet d' COleDateTime d'un objet existant d' COleDateTime .
le varSrc**)** d'**COleDateTime(**construit un objet d' COleDateTime .Essaie de convertir une structure d' VARIANT ou un objet de COleVariant à une valeur de date/heure (VT_DATE).Si la conversion réussit, la valeur convertie est copiée dans le nouvel objet d' COleDateTime .Si elle ne l'est pas, la valeur de l'objet d' COleDateTime a la valeur 0 (minuit, le 30 décembre 1899) et son état à incorrect.
COleDateTime(dtSrc) construit un objet d' COleDateTime d'une valeur de DATE .
COleDateTime(timeSrc) construit un objet d' COleDateTime d'une valeur d' time_t .
le systimeSrc**)** d'**COleDateTime(**construit un objet d' COleDateTime d'une valeur d' SYSTEMTIME .
COleDateTime(filetimeSrc) construit un objet d' COleDateTime d'une valeur d' FILETIME ..Notez qu' FILETIME utilise le temps UTC (UTC), si vous passez une heure locale dans la structure, les résultats sont non valides.Consultez heures du fichier dans Kit de développement logiciel Windows pour plus d'informations.
COleDateTime(nYear, nMonth, nDay, nHour, nMin, nSec) construit un objet d' COleDateTime des valeurs numériques spécifiées.
COleDateTime(wDosDate, wDosTime) construit un objet d' COleDateTime les valeurs spécifiées de date et heure de commande MS-DOS.

Pour plus d'informations sur le type de données d' time_t , consultez la fonction de temps dans la référence de la bibliothèque Runtime.

Pour plus d'informations, consultez les structures de SYSTEMTIME et de FILETIME dans Kit de développement logiciel Windows.

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

[!REMARQUE]

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

Exemple

time_t osBinaryTime;   // C run-time time (defined in <time.h>)
time(&osBinaryTime);   // Get the current time from the 
                     // operating system.

COleDateTime time1;   // initialized to 00:00am, 30 December 1899
                     // (and m_nStatus is valid!)

COleDateTime time2 = time1; // Copy constructor
COleDateTime time3(osBinaryTime);   // from time_t
COleDateTime time4(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999

SYSTEMTIME sysTime;   // Win32 time information
GetSystemTime(&sysTime);

COleDateTime time5(sysTime);