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的 SYSTEMTIME 和 FILETIME 结构。 请参见。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