◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
     The ctime function converts a time stored as a time_t value to a
     character string. The <timer> value is usually obtained from a
     call to time, which returns the number of seconds elapsed since
     00:00:00 Greenwich mean time, January 1, 1970.
 
     The string result produced by ctime contains exactly 26 characters
     and appears in the following form:
 
          Wed Jan 02 02:03:55 1980\n\0
 
     A 24-hour clock is used. All fields have a constant width. The
     newline character (\n) and the null character (\0) occupy the
     last two positions of the string.
 
     Calls to ctime modify the single statically allocated buffer used
     by the gmtime and localtime functions. Each call to one of these
     routines destroys the result of the previous call. The ctime
     function also shares a static buffer with the asctime function.
     Thus, a call to ctime destroys the results of any previous call to
     asctime, gmtime, or localtime.
 
     Return Value
 
     The ctime function returns a pointer to the character string
     result. If <timer> represents a date before 1980, ctime returns
     NULL.
                                    -♦-