◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
     The gmtime function converts the <timer> value to a structure. The
     <timer> argument represents the seconds elapsed since 00:00:00,
     January 1, 1970, Greenwich mean time. This value is usually
     obtained from a call to the time function.
 
     The gmtime function breaks down the <timer> value and stores it in
     a structure of type tm (defined in TIME.H). The structure result
     reflects Greenwich mean time, not local time. See the tm structure
     for information about its fields.
 
     The gmtime, mktime, and localtime functions use a single
     statically allocated structure to hold the result. Each call
     to one of these routines destroys the result of the previous call.
 
     DOS and OS/2 do not accommodate dates prior to 1980. If <timer>
     represents a date prior to 1980, gmtime returns NULL.
 
     Return Value
 
     The gmtime function returns a pointer to the structure result.
     If <timer> represents a date prior to 1980, gmtime returns NULL.
                                    -♦-