CTime::CTime

使用指定的时间创建初始化的新 CTime 对象。

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

参数

  • timeSrc
    指示已存在的一 CTime 对象。

  • time
    __time64_t 时间值,为秒数在1970年一月1日之后UTC。 注意到您的本地时间将进行调整。 例如,因此,如果位于纽约并传递参数创建 CTime 对象为0,CTime::GetMonth 将返回12。

    在Visual C++版本6.0和早期版本中,time 是 time_t的值。 Visual C++ .NET和最新转换为 __time64_t的一个 time_t 参数。

  • nYear, nMonth, nDay, nHour, nMin, nSec
    指示要复制的日期和时间值到新 CTime 对象。

  • nDST
    指示夏时制时间是否有效。 可以有三个值之一:

    • nDST 设置为0标准时间有效。

    • nDST 值设置为大的大于0夏时制时间有效。

    • nDST 设置为小于0的值默认值。 自动计算标准时间或夏时制时间是否有效。

  • wDosDate, wDosTime
    MS-DOS日期和时间值将转换为日期/时间值和复制到新的 CTime 对象。

  • st
    SYSTEMTIME 框架将转换为日期/时间值和复制到新的 CTime 对象。

  • ft
    FILETIME 框架将转换为日期/时间值和复制到新的 CTime 对象。

  • dbts
    对包含当前本地时间的 DBTimeStamp 结构的引用。

备注

每个构造函数下述:

  • CTime( ); 构造一个未初始化的 CTime 对象。 此构造函数允许您定义 CTime 对象数组。 您应该初始化与有效期这样的数组在使用之前。

  • CTime( const CTime& ); 构造从另一个 CTime 值的 CTime 对象。

  • CTime( __time64_t ); 构造从 __time64_t 类型的一 CTime 对象。 此构造函数应为UTC时间并将结果为本地时间在存储结果之前。

  • CTime( int, int,…); 构造从本地时间元素的一 CTime 对象与约束的每个元素为以下范围:

    组件

    范围

    nYear

    1970–3000

    nMonth

    1–12

    nDay

    1–31

    nHour

    0-23

    nMin

    0-59

    nSec

    0-59

    此构造函数对UTC的相应转换。 Microsoft基础选件类库的调试版本断言一个或多个时间元素是否超出范围。 您必须在调用之前验证参数。 此构造函数应为本地时间。

  • CTime( WORD, WORD ); 构造从指定的MS-DOS日期和时间值的 CTime 对象。 此构造函数应为本地时间。

  • CTime( const SYSTEMTIME& ); 构造从 SYSTEMTIME framework的一 CTime 对象。 此构造函数应为本地时间。

  • CTime( const FILETIME& ); 构造从 FILETIME framework的一 CTime 对象。 可能不会直接可能使用 CTimeFILETIME 初始化。 如果使用的 CFile 对象操作文件,CFile::GetStatus 通过 CTime 对象检索您的文件时间戳初始化 FILETIME 结构。 此构造函数假定基于UTC的时间和自动将值转换为本地时间。存储结果之前。

    备注

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

有关更多信息,请参见 Windows SDK的 SYSTEMTIMEFILETIME 结构。 请参见。Windows SDK的 MS-DOS日期和时间 项。

示例

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   

要求

Header: atltime.h

请参见

参考

CTime选件类

层次结构图

CTime::GetTime

CTime::GetCurrentTime

CTime::operator =