COleDateTime::COleDateTime

项目
02/21/2013

构造 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();

参数

dateSrc
要复制的现有 COleDateTime 对象到新 COleDateTime 对象。
pVarSrc
现有的 VARIANT 数据结构(可能 COleVariant 对象)将转换为日期/时间值(VT_DATE)和复制到新的 COleDateTime 对象。
dtSrc
要复制的日期/时间(DATE)值到新 COleDateTime 对象。
timeSrc
time_t 或 __time64_t 值将转换为日期/时间值和复制到新的 COleDateTime 对象。
systimeSrc
SYSTEMTIME 框架将转换为日期/时间值和复制到新的 COleDateTime 对象。
filetimeSrc
FILETIME 框架将转换为日期/时间值和复制到新的 COleDateTime 对象。请注意 FILETIME 使用协调通用时间(utc)，因此，如果您通过在结构的本地时间，结果将是不正确的。在参见 Windows SDK 的文件时有关更多信息。
nYear, nMonth, nDay, nHour, nMin, nSec
指示要复制的日期和时间值到新 COleDateTime 对象。
wDosDate, wDosTime
MS-DOS日期和时间值将转换为日期/时间值和复制到新的 COleDateTime 对象。
dbts
对包含当前本地时间的 DBTimeStamp 结构的引用。

备注

所有这些构造函数创建新的 COleDateTime 对象初始化为指定的值。下表显示了每个日期和时间元素的有效范围:

日期/时间元素	有效范围
年	100 – 9999
月份	0 – 12
日	0 – 31
小时	0 – 23
分钟	0 – 59
接下来	0 – 59

请注意日部分的实际上限因月和年元素。有关详细信息，请参见 SetDate 或 SetDateTime 成员函数。

以下每个构造函数的简要说明:

COleDateTime() 构造 COleDateTime 对象初始化为0 (午夜，1899年十二月30日)。
COleDateTime(dateSrc) 构造从现有 COleDateTime 对象的一 COleDateTime 对象。
COleDateTime(varSrc) 构造 COleDateTime 对象。尝试将一 VARIANT 结构或 COleVariant 对象对于日期/时间(VT_DATE)值。如果此转换成功，则转换的值复制到新的 COleDateTime 对象。如果不是，COleDateTime 对象的值设置为0 (午夜，1899年十二月30日)及其为无效的状态。
COleDateTime(dtSrc) 构造从 DATE 值的 COleDateTime 对象。
COleDateTime(timeSrc) 构造从 time_t 值的 COleDateTime 对象。
COleDateTime(systimeSrc) 构造从 SYSTEMTIME 值的 COleDateTime 对象。
COleDateTime(filetimeSrc) 构造从 FILETIME 值的 COleDateTime 对象。 . 请注意 FILETIME 使用协调通用时间(utc)，因此，如果您通过在结构的本地时间，结果将是不正确的。在参见 Windows SDK 的文件时有关更多信息。
COleDateTime(nYear，nMonth，nDay，nHour，nMin，nSec) 构造从指定的数值的一 COleDateTime 对象。
COleDateTime(wDosDate，wDosTime) 构造从指定的MS-DOS日期和时间值的 COleDateTime 对象。

有关 time_t 数据类型的更多信息，请在 "运行库参考时间函数。

有关更多信息，请参见中 Windows SDK的 SYSTEMTIME 和 FILETIME 结构。

有关 COleDateTime 值的区域的更多信息，请参见中的文章日期和时间:自动化支持。

备注

当OLEDB.h包括的时，使用 DBTIMESTAMP 参数的构造函数才可用。

示例

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