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

Guardian Native C Library Calls (t - z) time(3)
NAME
time - Gets time
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS
#include <time.h>
time_t time (
time_t *tloc);
PARAMETERS
tloc Points to the location where the return value is stored. When this parameter is a
null pointer, no value is stored.
DESCRIPTION
The time( ) function returns the time in seconds since the Epoch. The Epoch is referenced to
00:00:00 UTC (Coordinated Universal Time) January 1, 1970.
RETURN VALUES
Upon successful completion, the time() function returns the value of time in seconds since the
Epoch. Otherwise, the value ((time_t) -1) is returned.
RELATED INFORMATION
Functions: clock(3).
527192-018 Hewlett-Packard Company 7−17