CTimeSpan::CTimeSpan

Syntax

CTimeSpan();

CTimeSpan( const CTimeSpan& timeSpanSrc );

CTimeSpan( time_t time );

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

Parameters

timeSpanSrc

Indicates a CTimeSpan object that already exists.

time

Indicates a time_t time value.

lDays, nHours, nMins, nSecs

Indicate days, hours, minutes, and seconds.

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:

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

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