LOCALTIME(3) Library Functions Manual LOCALTIME(3)

localtime localtime_r — convert a time value to a broken-down local time

#include <time.h>

struct tm *localtime(const time_t *timer);
struct tm *localtime_r(const time_t *clock, struct tm *result);

The localtime() function converts the time in seconds since the Epoch pointed to by timer into a broken-down time, expressed as a local time. The function corrects for the timezone and any seasonal time adjustments. Local timezone information is used as though localtime() calls tzset(3) .

The localtime() interface need not be reentrant.

The localtime_r() function converts the calendar time pointed to by into a broken-down time stored in the structure to which result points. The localtime_r() function also returns a pointer to that same structure.

Unlike localtime(), the reentrant version is not required to set .

The localtime() function returns a pointer to the broken-down time structure.

Upon successful completion, localtime_r() returns a pointer to the structure pointed to by the argument result.

No errors are defined.

None.

The asctime(3) , ctime(3) , getdate(3) , gettimeofday(3) , gmtime(3) and localtime() functions return values in one of two static objects: a broken-down time structure and an array of char . Execution of any of the functions may overwrite the information returned in either of these objects by any of the other functions.

None.

asctime(3) , clock(3) , ctime(3) , difftime(3) , getdate(3) , gettimeofday(3) , gmtime(3) , mktime(3) , strftime(3) , strptime(3) , time(3) , utime(3) , <time.h> .

localtime() derived from Issue 1 of the SVID.

localtime_r() derived from the POSIX Threads Extension (1003.1c-1995).

February 1997 posix.fail