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

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

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

  • 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的 SYSTEMTIMEFILETIME 结构。

有关 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

请参见

参考

COleDateTime选件类

层次结构图

COleDateTime::SetDate

COleDateTime::SetDateTime

COleDateTime::SetTime

COleDateTime::GetStatus

COleDateTime::operator =

COleDateTime::m_dt

COleDateTime::m_status