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 成員函式。
備註
將參數值的繫結 (請參閱下表:
參數 |
界限 |
|---|---|
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 年 4 月 15 日 |
1789 |
7 |
14 |
1789 年 7 月 17 日 |
1925 |
2 |
30 |
Invalid |
10000 |
1 |
1 |
Invalid |
若要只設定日期，請參閱 COleDateTime::SetDate。 若要設定時刻，請參閱 COleDateTime::SetTime。
如需成員的資訊函式查詢這個 COleDateTime 物件的值，請參閱下列成員函式:
如需 COleDateTime 值的繫結的詳細資訊，請參閱本文 日期和時間:Automation 支援。
範例
GetStatus。請參閱範例。
需求
Header: atlcomtime.h