NAME

time − Gets time

LIBRARY

Standard C Library (libc.so, libc.a)

SYNOPSIS

#include <time.h>

time_t time(
        time_t ∗tloc);

PARAMETERS

tlocPoints 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 CUT (Coordinated Universal Time) 1 Jan 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: gettimeofday(2), clock(3), ctime(3), difftime(3), stime(3), strftime(3), strptime(3)

Standards: standards(5)