Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

Guardian Native C Library Calls (j - m) localtime_r(3)
• Compile your application using the #define_SPT_MODEL_ macro or an equivalent
compiler command option.
For more detailed information about writing multi-threaded or 64- bit applications for the Open
System Services environment, see the Open System Services Programme r’s Guide.
RETURN VALUES
Upon successful completion, the localtime_r() function returns a pointer to the type tm broken-
down time structure result, which contains converted local time information.
Values for the timeptr->tm_wday and timeptr->tm_yday members of the structure are set, and
the other members are set to specified local times. The final value of timeptr->tm_mday is not
set until the values of members timeptr->tm_mon and timeptr->tm_year are determined.
The values set in the tm structure are affected by the setting of the TZ environment variable and
calls to the tzset( ) function. For more information about the TZ environment variable, see the
tzset(3) reference page.
ERRORS
No error values are returned. This function does not set the errno variable.
RELATED INFORMATION
Functions: asctime(3), asctime_r(3), ctime(3), ctime_r(3), difftime(3), getenv(3), getenv_r(3),
gmtime(3), gmtime_r(3), mktime(3), strftime(3), time(3), tzset(3), utime(3).
STANDARDS CONFORMANCE
Interfaces documented on this reference page conform to the following industry standards:
• IEEE Std 1003.1-2004, POSIX System Application Program Interface
The use of the header file spthread.h is an HP exception to the POSIX standard.
527192-018 Hewlett-Packard Company 4−43