CTimeSpan Class

An amount of time, which is internally stored as the number of seconds in the time span.

class CTimeSpan

Members

Public Constructors

Name	Description
CTimeSpan::CTimeSpan	Constructs CTimeSpan objects in various ways.

Public Methods

Name	Description
CTimeSpan::Format	Converts a CTimeSpan into a formatted string.
CTimeSpan::GetDays	Returns a value that represents the number of complete days in this CTimeSpan.
CTimeSpan::GetHours	Returns a value that represents the number of hours in the current day (–23 through 23).
CTimeSpan::GetMinutes	Returns a value that represents the number of minutes in the current hour (–59 through 59).
CTimeSpan::GetSeconds	Returns a value that represents the number of seconds in the current minute (–59 through 59).
CTimeSpan::GetTimeSpan	Returns the value of the CTimeSpan object.
CTimeSpan::GetTotalHours	Returns a value that represents the total number of complete hours in this CTimeSpan.
CTimeSpan::GetTotalMinutes	Returns a value that represents the total number of complete minutes in this CTimeSpan.
CTimeSpan::GetTotalSeconds	Returns a value that represents the total number of complete seconds in this CTimeSpan.
CTimeSpan::Serialize64	Serializes data to or from an archive.

Operators

operator + –	Adds and subtracts CTimeSpan objects.
operator += –=	Adds and subtracts a CTimeSpan object to and from this CTimeSpan.
operator == < etc.	Compares two relative time values.

Remarks

CTimeSpan does not have a base class.

CTimeSpan functions convert seconds to various combinations of days, hours, minutes, and seconds.

The CTimeSpan object is stored in a __time64_t structure, which is 8 bytes.

A companion class, CTime, represents an absolute time.

The CTime and CTimeSpan classes are not designed for derivation. Because there are no virtual functions, the size of both CTime and CTimeSpan objects is exactly 8 bytes. Most member functions are inline.

For more information on using CTimeSpan, see the articles Date and Time, and Time Management in the Run-Time Library Reference.

Requirements

Header: atltime.h

See Also

Reference

asctime, _wasctime

_ftime, _ftime32, _ftime64

gmtime, _gmtime32, _gmtime64

localtime, _localtime32, _localtime64

strftime, wcsftime, _strftime_l, _wcsftime_l

time, _time32, _time64

Hierarchy Chart

Other Resources

ATL/MFC Shared Classes