Index Click this button to go to the index for this section.


time(3)

NAME

time - Gets time

LIBRARY

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

SYNOPSIS

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

PARAMETERS

tloc Points 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)