COleDateTime::COleDateTime
构造 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);
要求
Header: atlcomtime.h