Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CTimeSpan►                                   ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  CTimeSpan();
  CTimeSpan( const CTimeSpan& timeSpanSrc );
  CTimeSpan( time_t time );
  CTimeSpan( LONG lDays, int nHours, int nMins, int nSecs );
 
  Parameter                     Description
 
  <timeSpanSrc>                 A CTimeSpan object that already exists.
 
  <time>                        A time_t time value.
 
  <lDays>, <nHours>, <nMins>, <nSecs>
                                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
 
 
 
                                     -♦-