localtime—convert time to local representation #include <time.h>
struct tm *localtime(time_t *clock);
struct tm *localtime_r(time_t *clock, struct tm *res);
Description
localtime converts the time at clock into local time, then
converts its representation from the arithmetic representation to the
traditional representation defined by struct tm.
localtime constructs the traditional time representation in static
storage; each call to gmtime or localtime will overwrite the
information generated by previous calls to either function.
mktime is the inverse of localtime.
Returns
A pointer to the traditional time representation (struct tm).
Portability
ANSI C requires localtime.
localtime requires no supporting OS subroutines.