CTimeSpan::CTimeSpan

CTimeSpan();

CTimeSpan(constCTimeSpan&timeSpanSrc);

CTimeSpan(time_ttime**);**

CTimeSpan(LONGlDays**,intnHours,intnMins,intnSecs);**

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