Converts a time value to a structure.

#include <time.h>

struct tm *gmtime (const time_t *timer);

Parameters

timer

Pointer to stored TM structure, which represents the seconds elapsed since epoch time. This value is usually obtained from a call to time.

Remarks

gmtime breaks down the timer value and stores it in at TM. The structure result reflects GMT, not local time.

gmtime, mktime, and localtime use a single statically allocated structure to hold the result. Subsequent calls to these functions destroy the result of any previous call.

Return Values

A pointer to the TM structure.

Requirements

See Also

mktime, localtime, asctime, time, TIME.H for description of TM structure