共用方式為


COleDateTime Class

封裝用來 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 值至 DATEDATE*

公用資料成員

名稱

描述

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,對的後續呼叫, GetMonthGetDayGetHourGetMinuteGetSecond 失敗並傳回為。 在過去,您可以使用兩位數的日期,日期,但一定是以或大在 MFC 4.2 (含) 以後版本。

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

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

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

如需 COleDateTimeCOleDateTimeSpan 類別的詳細資訊,請參閱本文 日期和時間:Automation 支援

需求

**標題:**ATLComTime.h

請參閱

參考

COleVariant 類別

CTime Class

CTimeSpan Class

階層架構圖表

其他資源

ATL/MFC Shared Classes