CTime::GetGmtTm

Syntax

struct tm* GetGmtTm( struct tm* ptm = NULL ) const;

Parameters

ptm

Points to a buffer that will receive the time data. If this pointer is NULL, an internal, statically allocated buffer is used. The data in this default buffer is overwritten as a result of calls to other CTime member functions.

Remarks

Gets a struct tm that contains a decomposition of the time contained in this CTime object. GetGmtTm returns UCT.

Return Value

A pointer to a filled-in struct tm as defined in the include file time.h. The members are as follows:

Field Value Stored

tm_sec Seconds
tm_min Minutes
tm_hour Hours (0–23)
tm_mday Day of month (1–31)
tm_mon Month (0–11; January = 0)
tm_year Year (actual year minus 1900)
tm_wday Day of week (1–7; Sunday = 1)
tm_yday Day of year (0–365; January 1 = 0)
tm_isdst Always 0

Note:

The year in struct tm is in the range -1 to 136; the year in the CTime interface is in the range 1900 to 2036 (inclusive).

Example

See the example for GetLocalTm.