Guardian Native C Library Calls Reference Manual (G06.28+, H06.04+)

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 native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
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-005 Hewlett-Packard Company 7−9