asctime
◄Summary► ◄Example► ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
The asctime function converts a time stored as a structure to a
character string. The <timeptr> value is usually obtained from a
call to the gmtime or localtime function, both of which return a
pointer to a tm structure. See the tm structure for information
about its fields.
The string result produced by asctime contains exactly 26
characters. It has the form of the following example:
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. The asctime function uses a
single statically allocated buffer to hold the return string. Each
call to this routine destroys the result of the previous call.
Return Value
The asctime function returns a pointer to the character string
result. There is no error return.
-♦-