Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
─────Run-Time Library───────────────────────────────────────────────────────
 
     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
     midnight (00:00:00), December 31, 1899, Universal Coordinated
     Time.
 
     The string result produced by ctime contains exactly 26 characters
     and appears in the following form:
 
          Wed Jan 02 02:03:55 1991\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 midnight, December 31,
     1899, ctime returns NULL.
                                    -♦-