基本介紹
- 中文名：COleDateTime
- 屬性：一個浮點值
- 時間：1899年12月30日
- 對應：要取數據的相應部分
COleDateTime概述,COleDateTime類的成員,構造函式,屬性,操作,操作符,數據成員,歸檔/存儲,
COleDateTime概述
DATE類型實現為一個浮點值，從1899年12月30日午夜起計算“日”數。所以1899年12月31日午夜用數1.0來表示。相似的，1900年1月1日下午6時用數2.75來表示，1899年12月29日午夜是-1.0。而1899年12月29日下午6 時用數-0.25來表示。
注意：解釋時間各部分的值時，要取數據的相應部分的絕對值。
COleDateTime類處理了從100年1月1日到9999年12月31日的日期。
注意：
COleDateTime忽略了夏時制。可參閱在線上文檔《Visual C++程式設計師指南》中的“日期和時間：自動支持”，以了解詳細情況。該類型也可用於僅僅代表日期或時間的值。按通常約定，日期0(1899年12月30日)用於僅代表時間的值，相似地，時間0:00(午夜)用於僅代表日期的值。
如果創建一個日期小於100的COleDateTime對象,則此日期可被接受,但以後調用GetYear,GetMonth,GetDay,GetHour,GetMinute和GetSecond將失敗，並返回-1。以前可用兩位表示日期，但在MFC 4.2及以後的版本中，日期必須大於等於100。
要避免出現問題，可指定4位表示日期，例如：
COleDateTime mytime(1996,1,1,0,0,0);
COleDateTime值的算術運算使用伴生類COleDateTimeSpan。COleDateTimeSpan值代表相對時間，一個區間。它們之間的關係類似於CTime和CTimeSpan之間的關係。
頭檔案
#include <afxdisp.h>
COleDateTime類的成員
構造函式
COleDateTime構造一個COleDateTime對象
GetCurrentTime創建一個代表當前時間的COleDateTime對象（靜態成員函式）
屬性
GetStatus獲取該COleDateTime對象的狀態（有效性）
SetStatus設定該COleDateTime對象的狀態（有效性）
GetAsSystemTime轉換COleDateTime對象的時間用一個SYSTEMTIME數據結構表示
GetYear返回該COleDateTime對象代表的年
GetMonth返回該COleDateTime對象代表的月（1-12）
GetDay返回該COleDateTime對象代表的日（1-31）
GetHour返回該COleDateTime對象代表的時（0-23）
GetMinute返回該COleDateTime對象代表的分（0-59）
GetSecond返回該COleDateTime對象代表的秒（0-59）
GetDayOfWeek返回該COleDateTime對象代表的該天是星期幾（星期日=1）
GetDayOfYear返回該COleDateTime對象代表的該天是年內第幾天（1月1日=1）
操作
SetDateTime設定該COleDateTime對象值為指定的日期/時間值
SetDate設定該COleDateTime對象值為指定的日期值
SetTime設定該COleDateTime對象值為指定的時間值
Format生成一個代表一COleDateTime對象的格式化字元串
ParseDateTime從一個字元串讀取一個日期/時間值並設定為COleDateTime的值
操作符
operator DATE將一個COleDateTime值轉換為一個DATE
operator DATE*將一個COleDateTime值轉換為一個DATE*
operator =複製一個COleDateTime值
operator +, -加減COleDateTime值
operator +=, -=從該COleDateTime對象中加上或減去一個COleDateTime值
關係操作符比較兩個COleDateTime值
數據成員
m_dt包含該COleDateTime對象對應的DATE
m_status包含該COleDateTime對象的狀態
歸檔/存儲
operator <<從CArchive或CDumpContext輸出COleDateTime值
operator >>從CArchive輸入一個COleDateTime值
