COleDateTime::SetDateTime

将此 COleDateTime 对象的日期和时间。

int SetDateTime(
   int nYear,
   int nMonth,
   int nDay,
   int nHour,
   int nMin,
   int nSec 
) throw( );

参数

  • nYear, nMonth, nDay, nHour, nMin, nSec
    指示要复制的日期和时间元素到此 COleDateTime 对象。

返回值

零,则此 COleDateTime 对象的值已成功设置;否则,1。 此返回值基于该 DateTimeStatus 枚举类型。 有关更多信息,请参见 SetStatus 成员函数。

备注

为参数值的区域参见下表:

Parameter

范围

nYear

100 – 9999

nMonth

1 – 12

nDay

0 – 31

nHour

0 – 23

nMin

0 – 59

nSec

0 – 59

如果日溢出,它将转换为下个月的正确日,并且月和年相应递增。 零的日值指示上个月份的最后一天。 该行为相同。SystemTimeToVariantTime

如果参数指定的日期或时间值无效,此对象的状态设置为无效,并且不更改此对象的值。

这是时间值的一些示例:

nHour

nMin

nSec

1

3

3

01:03:03

23

45

0

23:45:00

25

30

0

Invalid

9

60

0

Invalid

这是日期值的一些示例:

nYear

nMonth

nDay

1995

4

15

1995 april 15日

1789

7

14

1789年七月17日

1925

2

30

Invalid

10000

1

1

Invalid

若要设置仅一个日期,请参见 COleDateTime::SetDate。 只设置时间,请参见 COleDateTime::SetTime

有关查询此 COleDateTime 对象值的成员函数的信息,请参见以下成员函数:

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

示例

GetStatus参见示例。

要求

Header: atlcomtime.h

请参见

参考

COleDateTime选件类

层次结构图

COleDateTime::COleDateTime

COleDateTime::SetDate

COleDateTime::SetTime

COleDateTime::operator =

COleDateTime::GetStatus

COleDateTime::m_dt