HP 3000 Manuals HP 3000 Manuals
time
Returns the number of seconds since the Epoch.
Syntax
#include <time.h>
time_t time (time_t *tloc);
Parameters
tloc If not NULL, a pointer to a variable of type time_t where the
number of seconds since the Epoch is returned. If NULL, no
value is stored.
Return Values
>=0 Success.
-1 An error occurred. The time is not returned, and errno is set
to indicate the error condition.
Description
The time() function calculates and returns the number of seconds since
the last Epoch (00:00:00 Coordinated Universal Time (UTC) January 1,
1970).
If tloc is not NULL, the same value is returned in the variable pointed
to by tloc. If tloc is NULL, no value is returned in tloc.
Implementation Considerations
Refer to the EFAULT error description below.
The TZ environment variable does not affect this function.
Errors
If an error occurs, errno is set to the following value:
EFAULT CAUSE The system detected a bad address in attempting to
use the tloc parameter.
ACTION Make sure that the pointer is correctly initialized.
See Also
<time.h>, POSIX.1 (Section 4.5.1)