COleDateTime 類別

封裝用來 OLE Automation 的 DATE 資料型別。

class COleDateTime

Members

公用建構函式

名稱	描述
COleDateTime::COleDateTime	建構 COleDateTime 物件。

公用方法

名稱	描述
COleDateTime::Format	產生 COleDateTime 物件中的格式化字串表示。
COleDateTime::GetAsDBTIMESTAMP	呼叫這個方法會取得 COleDateTime 物件的時間做為 DBTIMESTAMP 資料結構。
COleDateTime::GetAsSystemTime	呼叫這個方法會取得 COleDateTime 物件的時間做為 SYSTEMTIME 資料結構。
COleDateTime::GetAsUDATE	呼叫這個方法會取得 COleDateTime 的時間做為 UDATE 資料結構。
COleDateTime::GetCurrentTime	建立表示目前時間的 COleDateTime 物件 (靜態成員函式)。
COleDateTime::GetDay	傳回這 COleDateTime 物件所代表的日期也–範圍)。
COleDateTime::GetDayOfWeek	傳回這 COleDateTime 物件所表示的星期幾 (星期日) 的)。
COleDateTime::GetDayOfYear	傳回這 COleDateTime 物件表示中年份的日期 (一月一日) 的)。
COleDateTime::GetHour	傳回這 COleDateTime 物件代表的小時 (0) – ")。
COleDateTime::GetMinute	傳回這 COleDateTime 物件表示分鐘 (0) – 59)。
COleDateTime::GetMonth	傳回這 COleDateTime 物件所表示月份也– ()。
COleDateTime::GetSecond	傳回第二個物件代表這 COleDateTime (0) – 59)。
COleDateTime::GetStatus	取得狀況 (驗證) 這 COleDateTime 物件。
COleDateTime::GetYear	傳回這 COleDateTime 物件表示的年份。
COleDateTime::ParseDateTime	讀取字串中的日期/時間值並將 COleDateTime的值。
COleDateTime::SetDate	設定這 COleDateTime 物件中的值設定為指定的日期值的。
COleDateTime::SetDateTime	設定這 COleDateTime 物件中的值設定為指定的日期/時間值的。
COleDateTime::SetStatus	設定狀況 (驗證) 這 COleDateTime 物件。
COleDateTime::SetTime	設定這 COleDateTime 物件中的值設定為指定的時間值。

公用運算子

名稱	描述
COleDateTime::operator ==、COleDateTime::operator <等等.	比較兩 COleDateTime 值。
COleDateTime::operator +， COleDateTime::operator -	加減 COleDateTime 值。
COleDateTime::operator +=， COleDateTime::operator - =	從這個物件 COleDateTime 加減 COleDateTime 值。
COleDateTime::operator =	複製 COleDateTime 值。
COleDateTime::operator 日期， COleDateTime::operator Date*	轉換 COleDateTime 值至 DATE 或 DATE*。

公用資料成員

名稱	描述
COleDateTime::m_dt	包含這 COleDateTime 物件的基礎 日期 。
COleDateTime::m_status	包含這 COleDateTime 物件的狀態。

備註

COleDateTime 沒有基底類別。

它是其中一個 OLE Automation 的 Variant 資料型別的可能類型。 COleDateTime 值表示絕對日期和時間值。

DATE 型別會實作為浮點值。 天數而從年 12 月將日測量，午夜。 下表顯示一些日期及其關聯的值:

日期	值
而年 12 月多日午夜，	-1.0
而年 12 月多日上午)，	-1.25
而年 12 月將日午夜，	0.0
而年 12 月有日午夜，	1.0
年年一月一日上午、點，..	2.25

警告

請注意在中的資料表中，雖然日值變成負數在而年 12 月將日的午夜前，時間值不。例如， 6:00 上午由分數值為 0.5，0.25 永遠表示不論表示日期是否為正數 (而 12 月將日以後) 或負 (而 12 月將日之前)。這表示簡單的浮點比較一個代表的 7:00 AM 會錯誤地排序表示 12/29/1899 的 COleDateTime 6:00 上午，因為 later 同一天。

COleDateTime 類別控制代碼會傳遞到十二月月份日期為一月一日，，，到。 COleDateTime 類別使用西曆;它不支援凱撒曆日期。 COleDateTime 忽略日光節約時間。 (請參閱) 日期和時間:Automation 支援。

注意事項
您可以使用 %y 格式擷取以及一個雙位元組只年 1 月開始年份的日期。如果您在年 1 月目前使用中的 %y 日期格式，程式碼會產生判斷提示失敗。

這個型別也用來表示日期或時間值。 依照慣例，這個日期為 (而 12 月將日) 使用在時間值和時間 00:00 (午夜) 視為日期值使用。

如果您建立 COleDateTime 物件使用日期小於等於，則日期會接受，但是 GetYear，對的後續呼叫， GetMonth、 GetDay、 GetHour、 GetMinute和 GetSecond 失敗並傳回為。 在過去，您可以使用兩位數的日期，日期，但一定是以或大在 MFC 4.2 (含) 以後版本。

若要避免發生問題，請指定一個四位數的日期。 例如：

COleDateTime mytime(1996, 1, 1, 0, 0, 0); 

COleDateTime 值的基本算術運算使用附屬類別 COleDateTimeSpan。 COleDateTimeSpan 值會定義時間間隔。 這些類別之間的關係類似於 CTime 和 CTimeSpan。

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

需求

**標題:**ATLComTime.h

請參閱

參考

COleVariant 類別

CTime 的類別

CTimeSpan 類別

階層架構圖

其他資源

ATL/MFC 共用類別