|This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.|
Convert calendar time to local time
#include <time.h> char* ctime( const time_t* timer ); char* ctime_r( const time_t* timer, char* buf );
- A pointer to a time_t object that contains the time that you want to convert to a string.
- (ctime_r() only) A buffer in which ctime_r() can store the resulting string. This buffer must be large enough to hold at least 26 characters.
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The ctime() and ctime_r() functions convert the time pointed to by timer to local time and formats it as a string containing exactly 26 characters in the form:
Tue May 7 10:40:27 2002\n\0
|This function:||Is equivalent to calling:|
|ctime()||asctime( localtime ( timer ) );|
|ctime_r()||asctime_r( localtime ( timer ), buf )|
|The ctime() function places the result string in a static
buffer that's reused each time you call ctime() or
could also change the date in this static buffer.
The result string for ctime_r() is contained in the buffer pointed to by buf.
All fields have a constant width. The newline character '\n' and NUL character '\0' occupy the last two positions of the string.
Whenever the ctime() or ctime_r() functions are called, the tzset() function is also called.
The calendar time is usually obtained by using the time() function. That time is Coordinated Universal Time (UTC) (formerly known as Greenwich Mean Time (GMT)).
You typically set the time on the computer with the date command to reflect Coordinated Universal Time (UTC), and then use the TZ environment variable or _CS_TIMEZONE configuration string to establish the local time zone. For more information, see “Setting the time zone” in the Configuring Your Environment chapter of the Neutrino User's Guide.
A pointer to the string containing the formatted local time, or NULL if an error occurs.
The asctime() and ctime() functions place their results in a static buffer that's reused for each call to asctime() or ctime().
“Setting the time zone” in the Configuring Your Environment chapter of the Neutrino User's Guide