The
time ();
function
returns the value of time in seconds since 0 hours, 0 minutes,
0 seconds, January 1, 1970, Coordinated Universal Time.
If an error occurs,
time ();
returns the value
Po Vt time_t Pc Ns -1 .
The return value is also stored in
* tloc
provided that
tloc
is non-null.
ERRORS
The
time ();
function may fail for any of the reasons described in
gettimeofday(2).
Neither
St -isoC-99
nor
St -p1003.1-2001
requires
time ();
to set
errno
on failure; thus, it is impossible for an application to distinguish
the valid time value -1 (representing the last UTC second of 1969)
from the error return value.
Systems conforming to earlier versions of the C and
POSIX
standards (including older versions of
Fx )
did not set
* tloc
in the error case.
