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