CTimeSpan

CTimeSpan::CTimeSpan

CTimeSpan( );

CTimeSpan( const CTimeSpan& timeSpanSrc );

CTimeSpan( time_t time );

CTimeSpan( LONG lDays, int nHours, int nMins, int nSecs );

Parameters

timeSpanSrc

A CTimeSpan object that already exists.

time

A time_t time value.

lDays, nHours, nMins, nSecs

Days, hours, minutes, and seconds, respectively.

Remarks

All these constructors create a new CTimeSpan object initialized with the specified relative time. Each constructor is described below:

• CTimeSpan( ); Constructs an uninitialized CTimeSpan object.
  
  
• CTimeSpan( const CTimeSpan& ); Constructs a CTimeSpan object from another CTimeSpan value.
  
  
• CTimeSpan( time_t ); Constructs a CTimeSpan object from a time_t type. This value should be the difference between two absolute time_t values.
  
  
• CTimeSpan( LONG, int, int, int ); Constructs a CTimeSpan object from components with each component constrained to the following ranges:

  Component	Range
  lDays	0–25,000 (approximately)
  nHours	0–23
  nMins	0–59
  nSecs	0–59

  
  

Note that the Debug version of the Microsoft Foundation Class Library asserts if one or more of the time-day components is out of range. It is your responsibility to validate the arguments prior to calling.

Example

// example for CTimeSpan::CTimeSpan
CTimeSpan ts1;  // Uninitialized time value
CTimeSpan ts2a( ts1 ); // Copy constructor
CTimeSpan ts2b = ts1; // Copy constructor again
CTimeSpan ts3( 100 ); // 100 seconds
CTimeSpan ts4( 0, 1, 5, 12 );    // 1 hour, 5 minutes, and 12 seconds

CTimespan Overview | Class Members | Hierarchy Chart 

CTimeSpan Class Members

Construction

CTimeSpan

Constructs CTimeSpan objects in various ways.

Extraction

GetDays	Returns the number of complete days in this CTimeSpan.
GetHours	Returns the number of hours in the current day (–23 through 23).
GetTotalHours	Returns the total number of complete hours in this CTimeSpan.
GetMinutes	Returns the number of minutes in the current hour (–59 through 59).
GetTotalMinutes	Returns the total number of complete minutes in this CTimeSpan.
GetSeconds	Returns the number of seconds in the current minute (–59 through 59).
GetTotalSeconds	Returns the total number of complete seconds in this CTimeSpan.

Conversion

Format

Converts a CTimeSpan into a formatted string.

Operators

operator =	Assigns new time-span values.
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.

Archive/Dump

operator <<	Outputs a CTimeSpan object to CArchive or CDumpContext.
operator >>	Inputs a CTimeSpan object from CArchive.

CTimespan Overview | Hierarchy Chart 

 

CTimeSpanClass.cpp