COleDateTime::SetDate

發行項
02/28/2013

將這個物件 COleDateTime 日期。

int SetDate(
   int nYear,
   int nMonth,
   int nDay 
) throw( );

參數

nYear, nMonth, nDay
表示要複製的日期元件。這 COleDateTime 物件。

傳回值

如果為零，這個物件值的深層 COleDateTime 成功設定;否則， 1。這個傳回值是以這個 DateTimeStatus 列舉型別。如需詳細資訊，請參閱 SetStatus 成員函式。

備註

這個日期設定為指定的值。時間設定逾時，午夜 0。

將參數值的繫結 (請參閱下表:

參數	界限
nYear	100 – 9999
nMonth	1 – 12
nDay	0 – 31

如果日溢位，會轉換為下個月的正確的日期，然後月份和年份適當地遞增。日期零值指示上下月份的最後一天。行為與 SystemTimeToVariantTime。

如果參數指定的日期是無效值，這個物件的狀態設定為 COleDateTime::invalid。您應該使用 GetStatus 檢查 DATE 值的有效性，且不應假設， m_dt 的值會保持未修改。

這個日期值的一些範例:

nYear	nMonth	nDay	值
2000	2	29	2000 年 2 月 29 日
1776	7	4	1776 年 7 月 4 日
1925	4	35	1925 年 4 月 35 日 (無效的日期)。
10000	1	1	10000 年 1 月 1 日 (無效的日期)。

要設定其日期和時間，請參閱 COleDateTime::SetDateTime。

如需成員的資訊函式查詢這個 COleDateTime 物件的值，請參閱下列成員函式:

如需 COleDateTime 值的繫結的詳細資訊，請參閱本文日期和時間:Automation 支援。

範例

// set only the date, time set to midnight
dt.SetDate(1999, 3, 19);
ASSERT(dt.GetYear() == 1999);
ASSERT(dt.GetDay() == 19);
ASSERT(dt.GetMonth() == 3);
ASSERT(dt.GetHour() == 0);
ASSERT(dt.GetMinute() == 0);
ASSERT(dt.GetSecond() == 0);

// setting the time only resets the date to 1899!
dt.SetTime(22, 15, 0);
ASSERT(dt.GetYear() == 1899);
ASSERT(dt.GetDay() == 30);
ASSERT(dt.GetMonth() == 12);
ASSERT(dt.GetHour() == 22);
ASSERT(dt.GetMinute() == 15);
ASSERT(dt.GetSecond() == 0);