localtime_r()

convert time in seconds since Epoch to local time (re-entrant) 

Function

SYNOPSIS

#include <time.h>

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

DESCRIPTION

The localtime_r() function converts a time in seconds since the Epoch (00:00:00 UTC, January 1, 1970) into a broken-down time, expressed as a local time. The function corrects for the time zone and any seasonal adjustments. Local time zone information is used as though localtime_r() calls tzset().

This function is reentrant.

PARAMETERS

clock 

Is the time to be converted.

result 

Points to the structure where the converted time is stored.

RETURN VALUES

On success, localtime_r() return result. On error, it returns NULL.

CONFORMANCE

POSIX.1 (1996).

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

Refer to tzset() for details on setting time zone information.

AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
asctime(), asctime_r(), clock(), ctime(), ctime_r(), difftime(), gmtime(), gmtime_r(), localtime(), mktime(), strftime(), time(), tzset()

PTC MKS Toolkit 10.5 Documentation Build 40.