CFileTimeSpan 類別

這個類別提供方法來管理與檔案相關聯的相對日期和時間值。

語法

class CFileTimeSpan

成員

公用建構函式

名稱	描述
CFileTimeSpan::CFileTimeSpan	建構函式。

公用方法

名稱	描述
CFileTimeSpan::GetTimeSpan	呼叫這個方法，從 CFileTimeSpan 物件擷取時間範圍。
CFileTimeSpan::SetTimeSpan	呼叫這個方法以設定 物件的時間範圍 CFileTimeSpan 。

公用運算子

名稱	描述
CFileTimeSpan::operator -	對 物件執行減法 CFileTimeSpan 。
CFileTimeSpan::operator !=	比較兩個 CFileTimeSpan 物件是否不相等。
CFileTimeSpan::operator +	對 物件執行 CFileTimeSpan 加法。
CFileTimeSpan::operator +=	對 CFileTimeSpan 物件執行加法，並將結果指派給目前的 物件。
CFileTimeSpan::operator <	比較兩個 CFileTimeSpan 物件以判斷較小的物件。
CFileTimeSpan::operator <=	比較兩個 CFileTimeSpan 物件，以判斷相等或較小。
CFileTimeSpan::operator =	指派運算子。
CFileTimeSpan::operator -=	對 物件執行減法 CFileTimeSpan ，並將結果指派給目前的 物件。
CFileTimeSpan::operator ==	比較兩個 CFileTimeSpan 物件是否相等。
CFileTimeSpan::operator >	比較兩個 CFileTimeSpan 物件以判斷較大的物件。
CFileTimeSpan::operator >=	比較兩個 CFileTimeSpan 物件，以判斷相等或更大。

備註

類別 CFileTimeSpan 提供方法來處理檔案系統所使用的單位中相對時間週期。 這些單位通常用於檔案作業，例如檔案建立、上次存取或上次修改時。 這個類別的方法經常與類別 物件搭配 CFileTime 使用。

範例

請參閱 的 CFileTime::Millisecond 範例。

需求

標頭： atltime.h

CFileTimeSpan::CFileTimeSpan

建構函式。

CFileTimeSpan() throw();
CFileTimeSpan(const CFileTimeSpan& span) throw();
CFileTimeSpan(LONGLONG nSpan) throw();

參數

span
現有的 CFileTimeSpan 物件。

nSpan
單位的 FILETIME 一段時間。

備註

CFileTimeSpan您可以使用現有的 CFileTimeSpan 物件來建立物件，或以 100 奈秒 FILETIME 單位的 64 位值表示。 如需詳細資訊，請參閱CFileTime。 預設建構函式會將時間範圍設定為 0。

CFileTimeSpan::GetTimeSpan

呼叫這個方法，從 CFileTimeSpan 物件擷取時間範圍。

LONGLONG GetTimeSpan() const throw();

傳回值

傳回 100 奈秒 FILETIME 單位的時間範圍。 如需詳細資訊，請參閱CFileTime。

CFileTimeSpan::operator -

對 物件執行減法 CFileTimeSpan 。

CFileTimeSpan operator-(CFileTimeSpan span) const throw();

參數

span
CFileTimeSpan 物件。

傳回值

CFileTimeSpan傳回 物件，表示兩個時間範圍之間的差異結果。

CFileTimeSpan::operator !=

比較兩個 CFileTimeSpan 物件是否不相等。

bool operator!=(CFileTimeSpan span) const throw();

參數

span
要比較的 CFileTimeSpan 物件。

傳回值

如果比較的專案不等於 物件， CFileTimeSpan 則傳 TRUE 回 ，否則 FALSE 傳回 。

CFileTimeSpan::operator +

對 物件執行 CFileTimeSpan 加法。

CFileTimeSpan operator+(CFileTimeSpan span) const throw();

參數

span
CFileTimeSpan 物件。

傳回值

傳 CFileTimeSpan 回 物件，其中包含兩個時間範圍的總和。

CFileTimeSpan::operator +=

對 物件執行 CFileTimeSpan 加法，並將結果指派給目前的 物件。

CFileTimeSpan& operator+=(CFileTimeSpan span) throw();

參數

span
CFileTimeSpan 物件。

傳回值

傳回包含兩個時間範圍總和的更新 CFileTimeSpan 物件。

CFileTimeSpan::operator <

比較兩個 CFileTimeSpan 物件以判斷較小的物件。

bool operator<(CFileTimeSpan span) const throw();

參數

span
要比較的 CFileTimeSpan 物件。

傳回值

TRUE如果第一個物件小於 （也就是說，代表較短的時間週期），則傳回 ，否則 FALSE 為 。

CFileTimeSpan::operator <=

比較兩個 CFileTimeSpan 物件，以判斷相等或較小。

bool operator<=(CFileTimeSpan span) const throw();

參數

span
要比較的 CFileTimeSpan 物件。

傳回值

TRUE如果第一個物件小於 （也就是表示較短的時間週期），或等於第二個，則傳回 ，否則 FALSE 為 。

CFileTimeSpan::operator =

指派運算子。

CFileTimeSpan& operator=(const CFileTimeSpan& span) throw();

參數

span
CFileTimeSpan 物件。

傳回值

傳回更新 CFileTimeSpan 的物件。

CFileTimeSpan::operator -=

對 物件執行減法 CFileTimeSpan ，並將結果指派給目前的 物件。

CFileTimeSpan& operator-=(CFileTimeSpan span) throw();

參數

span
CFileTimeSpan 物件。

傳回值

傳回更新 CFileTimeSpan 的物件。

CFileTimeSpan::operator ==

比較兩個 CFileTimeSpan 物件是否相等。

bool operator==(CFileTimeSpan span) const throw();

參數

span
要比較的 CFileTimeSpan 物件。

傳回值

如果物件相等，則傳 TRUE 回 ，否則 FALSE 傳回 。

CFileTimeSpan::operator >

比較兩個 CFileTimeSpan 物件以判斷較大的物件。

bool operator>(CFileTimeSpan span) const throw();

參數

span
要比較的 CFileTimeSpan 物件。

傳回值

TRUE如果第一個物件大於 （也就是說，代表較長的時間週期），則傳回 ，否則 FALSE 為 。

CFileTimeSpan::operator >=

比較兩個 CFileTimeSpan 物件，以判斷相等或更大。

bool operator>=(CFileTimeSpan span) const throw();

參數

span
要比較的 CFileTimeSpan 物件。

傳回值

TRUE如果第一個物件大於 （也就是說，代表較長的時間週期），或等於第二個，則傳回 ，否則 FALSE 為 。

CFileTimeSpan::SetTimeSpan

呼叫這個方法以設定 物件的時間範圍 CFileTimeSpan 。

void SetTimeSpan(LONGLONG nSpan) throw();

參數

nSpan
以 100 奈秒 FILETIME 為單位的時間範圍新值。 如需詳細資訊，請參閱CFileTime。

另請參閱

FILETIME
CFileTime 類別
階層圖
ATL/MFC 共用類別