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.
ctime
◄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.
-♦-