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

Guardian Native C Library Calls (g - i) gmtime_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 Programmer’s Guide.
RETURN VALUES
Upon successful completion, the gmtime_r() function returns a pointer to the type tm broken-
down time structure result, which contains converted UTC 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 times since the Epoch. The final value of
timeptr->tm_mday is not set until the values of members timeptr->tm_mon and
timeptr->tm_year are determined.
When an error occurs or UTC is not available, this function returns a null pointer.
Note that the tm_isdst field of the tm structure is always set to 0 (zero) by a call to the
gmtime_r() function.
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),
localtime(3), localtime_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 3−79