Convert calendar time to local time
#include <time.h> struct tm *localtime( const time_t *timer );
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The localtime() function converts the calendar time pointed to by timer into local time, storing the information in a struct tm. Whenever you call localtime(), it calls tzset().
You typically get a calendar time by calling time(). That time is Coordinated Universal Time (UTC, formerly known as Greenwich Mean Time or GMT).
The localtime() function places the converted time in a
static tm structure that's reused each time you call
localtime() or
gmtime().
Calling
asctime()
or
ctime()
could also change the data in this static buffer.
In a multithreaded application, use localtime_r(). |
You typically use the date command to set the computer's internal clock using Coordinated Universal Time (UTC). 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 static tm structure containing the time information.
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | No |
Signal handler | No |
Thread | No |
asctime(), asctime_r(), clock(), ctime(), ctime_r(), difftime(), gmtime(), gmtime_r(), mktime(), localtime_r(), strftime(), time(), tm, tzset()
“Setting the time zone” in the Configuring Your Environment chapter of the Neutrino User's Guide