Index Index for Section 3
Index Alphabetical listing for T 

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)