Download this book in PDF (1785 KB)

time(2)

Name | Synopsis | Description | Return Values | Attributes | See Also

Name

time– get time

Synopsis

#include <sys/types.h>
#include <time.h>

time_t time(time_t *tloc);

Description

The time() function returns the value of time in seconds since 00:00:00 UTC, January 1, 1970.

If tloc is non-zero, the return value is also stored in the location to which tloc points. If tloc points to an illegal address, time() fails and its actions are undefined.

Return Values

Upon successful completion, time() returns the value of time. Otherwise, (time_t)-1 is returned and errno is set to indicate the error.

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Standard
MT-Level	Async-Signal-Safe

See Also

stime(2), ctime(3C), attributes(5), standards(5)

Name | Synopsis | Description | Return Values | Attributes | See Also