time

NAME

<span class="Nm" id="time">time</span>

INTERFACE

#include <time.h> time_t time ( time_t *tloc )

DESCRIPTION

The time function returns the value of time in seconds since 0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated Universal Time, without including leap seconds. If an error occurs, time returns the value ( <span class="Vt">time_t</span> <span class="Vt">)</span>-1 &#92;n &#92;n The return value is also stored in * <span class="Va">tloc</span>, provided that <span class="Va">tloc</span> is non-null.

ERRORS

The time function may fail for any of the reasons described in reference:gettimeofday (2) .

SEE ALSO

reference:gettimeofday (2) , ctime (3)

STANDARDS

The time function conforms to

BUGS

Neither nor requires time to set <span class="Va">errno</span> 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. &#92;n &#92;n Systems conforming to earlier versions of the C and <span class="Tn">POSIX</span> standards (including older versions of FreeBSD did not set * <span class="Va">tloc</span> in the error case.

HISTORY

A time function appeared in Version 6 AT&T UNIX