Share via


CTime

CTime does not have a base class.

A CTime object represents an absolute time and date. The CTime class incorporates the ANSI time_t data type and its associated run-time functions, including the ability to convert to and from a Gregorian date and 24-hour time.

CTime values are based on coordinated universal time (UTC), which is equivalent to Greenwich mean time (GMT). The local time zone is controlled by the TZ environment variable.

When creating a CTime, set the nDST parameter to 0 to indicate that standard time is in effect, or to a value greater than 0 to indicate that daylight savings time is in effect, or to a value less than zero to have the C run-time library code compute whether standard time or daylight savings time is in effect. tm_isdst is a required field. If not set, its value is undefined and the return value from is unpredictable. If timeptr points to a tm structure returned by a previous call to asctime, gmtime, or localtime, the tm_isdst field contains the correct value.

See the Run-Time Library Reference for more information on the time_t data type and the run-time functions that are used by CTime.

A companion class, CTimeSpan, represents a time interval — the difference between two CTime objects.

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

For more information on using CTime, see the article in Visual C++ Programmer’s Guide and in the Run-Time Library Reference.

#include <afx.h>

Class MembersHierarchy Chart

 See Also   Run-time functions: , , , , ,