CFileTimeSpan class
This class provides methods for managing relative date and time values associated with a file.
Syntax
class CFileTimeSpan
Members
Public constructors
| Name | Description |
|---|---|
CFileTimeSpan::CFileTimeSpan |
The constructor. |
Public methods
| Name | Description |
|---|---|
CFileTimeSpan::GetTimeSpan |
Call this method to retrieve the time span from the CFileTimeSpan object. |
CFileTimeSpan::SetTimeSpan |
Call this method to set the time span of the CFileTimeSpan object. |
Public operators
| Name | Description |
|---|---|
CFileTimeSpan::operator - |
Performs subtraction on a CFileTimeSpan object. |
CFileTimeSpan::operator != |
Compares two CFileTimeSpan objects for inequality. |
CFileTimeSpan::operator + |
Performs addition on a CFileTimeSpan object. |
CFileTimeSpan::operator += |
Performs addition on a CFileTimeSpan object and assign the result to the current object. |
CFileTimeSpan::operator < |
Compares two CFileTimeSpan objects to determine the lesser. |
CFileTimeSpan::operator <= |
Compares two CFileTimeSpan objects to determine equality or the lesser. |
CFileTimeSpan::operator = |
The assignment operator. |
CFileTimeSpan::operator -= |
Performs subtraction on a CFileTimeSpan object and assign the result to the current object. |
CFileTimeSpan::operator == |
Compares two CFileTimeSpan objects for equality. |
CFileTimeSpan::operator > |
Compares two CFileTimeSpan objects to determine the larger. |
CFileTimeSpan::operator >= |
Compares two CFileTimeSpan objects to determine equality or the larger. |
Remarks
The CFileTimeSpan class provides methods to handle relative periods of time in the units the file system uses. These units are often used in file operations, such as when a file was created, last accessed, or last modified. The methods of this class are frequently used together with CFileTime class objects.
Example
See the example for CFileTime::Millisecond.
Requirements
Header: atltime.h
CFileTimeSpan::CFileTimeSpan
The constructor.
CFileTimeSpan() throw();
CFileTimeSpan(const CFileTimeSpan& span) throw();
CFileTimeSpan(LONGLONG nSpan) throw();
Parameters
span
An existing CFileTimeSpan object.
nSpan
A period of time in FILETIME units.
Remarks
The CFileTimeSpan object can be created using an existing CFileTimeSpan object, or expressed as a 64-bit value in 100-nanosecond FILETIME units. For more information, see CFileTime. The default constructor sets the time span to 0.
CFileTimeSpan::GetTimeSpan
Call this method to retrieve the time span from the CFileTimeSpan object.
LONGLONG GetTimeSpan() const throw();
Return value
Returns the time span in 100-nanosecond FILETIME units. For more information, see CFileTime.
CFileTimeSpan::operator -
Performs subtraction on a CFileTimeSpan object.
CFileTimeSpan operator-(CFileTimeSpan span) const throw();
Parameters
span
A CFileTimeSpan object.
Return value
Returns a CFileTimeSpan object representing the result of the difference between two time spans.
CFileTimeSpan::operator !=
Compares two CFileTimeSpan objects for inequality.
bool operator!=(CFileTimeSpan span) const throw();
Parameters
span
The CFileTimeSpan object to be compared.
Return value
Returns TRUE if the item being compared isn't equal to the CFileTimeSpan object; otherwise FALSE.
CFileTimeSpan::operator +
Performs addition on a CFileTimeSpan object.
CFileTimeSpan operator+(CFileTimeSpan span) const throw();
Parameters
span
A CFileTimeSpan object.
Return value
Returns a CFileTimeSpan object containing the sum of the two time spans.
CFileTimeSpan::operator +=
Performs addition on a CFileTimeSpan object and assigns the result to the current object.
CFileTimeSpan& operator+=(CFileTimeSpan span) throw();
Parameters
span
A CFileTimeSpan object.
Return value
Returns the updated CFileTimeSpan object containing the sum of the two time spans.
CFileTimeSpan::operator <
Compares two CFileTimeSpan objects to determine the lesser.
bool operator<(CFileTimeSpan span) const throw();
Parameters
span
The CFileTimeSpan object to be compared.
Return value
Returns TRUE if the first object is less (that is, represents a shorter time period) than the second, otherwise FALSE.
CFileTimeSpan::operator <=
Compares two CFileTimeSpan objects to determine equality or the lesser.
bool operator<=(CFileTimeSpan span) const throw();
Parameters
span
The CFileTimeSpan object to be compared.
Return value
Returns TRUE if the first object is less than (that is, represents a shorter time period) or equal to the second, otherwise FALSE.
CFileTimeSpan::operator =
The assignment operator.
CFileTimeSpan& operator=(const CFileTimeSpan& span) throw();
Parameters
span
A CFileTimeSpan object.
Return value
Returns the updated CFileTimeSpan object.
CFileTimeSpan::operator -=
Performs subtraction on a CFileTimeSpan object and assigns the result to the current object.
CFileTimeSpan& operator-=(CFileTimeSpan span) throw();
Parameters
span
A CFileTimeSpan object.
Return value
Returns the updated CFileTimeSpan object.
CFileTimeSpan::operator ==
Compares two CFileTimeSpan objects for equality.
bool operator==(CFileTimeSpan span) const throw();
Parameters
span
The CFileTimeSpan object to be compared.
Return value
Returns TRUE if the objects are equal, otherwise FALSE.
CFileTimeSpan::operator >
Compares two CFileTimeSpan objects to determine the larger.
bool operator>(CFileTimeSpan span) const throw();
Parameters
span
The CFileTimeSpan object to be compared.
Return value
Returns TRUE if the first object is greater than (that is, represents a longer time period) than the second, otherwise FALSE.
CFileTimeSpan::operator >=
Compares two CFileTimeSpan objects to determine equality or the larger.
bool operator>=(CFileTimeSpan span) const throw();
Parameters
span
The CFileTimeSpan object to be compared.
Return value
Returns TRUE if the first object is greater than (that is, represents a longer time period) or equal to the second, otherwise FALSE.
CFileTimeSpan::SetTimeSpan
Call this method to set the time span of the CFileTimeSpan object.
void SetTimeSpan(LONGLONG nSpan) throw();
Parameters
nSpan
The new value for the time span in 100-nanosecond FILETIME units. For more information, see CFileTime.
See also
FILETIME
CFileTime class
Hierarchy chart
ATL/MFC shared classes
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for