CTime 的類別

發行項
03/26/2013

表示絕對日期和時間。

class CTime

Members

公用建構函式

名稱	描述
CTime::CTime	建構 CTime 物件以各種方式。

公用方法

名稱	描述
CTime::Format	轉換 CTime 物件中根據本地時區 (的格式化字串。
CTime::FormatGmt	轉換 CTime 物件中根據 UTC —的格式化字串。
CTime::GetAsDBTIMESTAMP	轉換為相容的 DBTimeStamp Win32 結構的 CTime 物件儲存的時間資訊。
CTime::GetAsSystemTime	轉換為相容的 SYSTEMTIME Win32 結構的 CTime 物件儲存的時間資訊。
CTime::GetCurrentTime	建立表示目前時間的 CTime 物件 (靜態成員函式)。
CTime::GetDay	傳回日期 CTime 由物件表示。
CTime::GetDayOfWeek	傳回 CTime 物件所表示的星期幾。
CTime::GetGmtTm	提供基礎 UTC —的元件分割 CTime 物件。
CTime::GetHour	傳回 CTime 物件所代表的小時。
CTime::GetLocalTm	會根據本地時區的元件—分割 CTime 物件。
CTime::GetMinute	傳回 CTime 物件表示分鐘。
CTime::GetMonth	傳回 CTime 物件所表示的月份。
CTime::GetSecond	傳回 CTime 物件所表示的第二個。
CTime::GetTime	傳回指定之物件的 CTime__time64_t 值。
CTime::GetYear	傳回 CTime 物件所表示的年份。
CTime::Serialize64	將資料還原序列化至檔案。

運算子

運算子 + –	這些運算子增加和減少 CTimeSpan 和 CTime 物件。
+=運算子， – =	這些運算子於這個物件 CTime 增加和減少 CTimeSpan 物件。
=運算子	指派運算子。
運算子==， <等等_.	比較運算子。

備註

CTime 不具有基底類別。

CTime 值是以 Coordinated Universal Time (UTC)，以國際標準時間 (Greenwich Mean Time， GMT)。請參閱時間管理關於時區的資訊決定。

當您建立 CTime 物件時，請設定 nDST 參數設定為 0 表示標準時間實際上是，或設定為大於的值 0 表示日光節約時間為作用中，或者為值低於零 C 執行階段程式庫程式碼估計標準時間或日光節約時間是否在作用中。 tm_isdst 為必要欄位。如果未設定，則它的值未定義，並從 mktime 的傳回值無法預期。如果對先前呼叫方法所傳回的 tm 結構的 timeptr 指向 asctime_s、 _gmtime_s或 localtime_s， tm_isdst 欄位包含無效的值。

附屬類別， CTimeSpan，表示時間間隔。

CTime 和 CTimeSpan 類別 (Class) 不可用於衍生設計。由於沒有虛擬函式， CTime 和 CTimeSpan 物件大小正好是 8 個位元組。大部分成員函式內嵌。

注意事項
表示資料限制為 12/31/3000。這個下限是 1/1/1970 12:00: 00 AM GMT。

如需使用 CTime的資訊，請參閱《執行階段程式庫參考的文件日期及時間和時刻表。

注意事項
從 MFC 變更的 CTime 結構 MFC 7.1 至 8.0。如果您要還原序列化 CTime 結構使用 operator _<_< 在 MFC 8.0 (含) 以後版本中，產生的檔案將無法讀取在 MFC 較舊的版本。