time(3) [osx man page]

TIME(3) 						   BSD Library Functions Manual 						   TIME(3)

NAME

     time -- get time of day

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #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 (time_t)-1.

     The return value is also stored in *tloc, provided that tloc is non-null.

ERRORS

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

SEE ALSO

     gettimeofday(2), ctime(3)

STANDARDS

     The time function conforms to IEEE Std 1003.1-2001 (``POSIX.1'').

HISTORY

     A time() function appeared in Version 6 AT&T UNIX.

BUGS

     Neither ISO/IEC 9899:1999 (``ISO C99'') nor IEEE Std 1003.1-2001 (``POSIX.1'') requires time() to set errno on failure; thus, it is impossi-
     ble for an application to distinguish the valid time value -1 (representing the last UTC second of 1969) from the error return value.

     Systems conforming to earlier versions of the C and POSIX standards (including older versions of FreeBSD) did not set *tloc in the error
     case.

BSD
								   July 18, 2003							       BSD

Check Out this Related Man Page

time(2) 							   System Calls 							   time(2)

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)

SunOS 5.11							    28 Dec 1996 							   time(2)

Linux and UNIX Man Pages

time(3) [osx man page]

Check Out this Related Man Page

2 More Discussions You Might Find Interesting

1. UNIX for Advanced & Expert Users

How To Fetch Time From Putside Source On Unix Platform?

Discussion started by: pesty

2. AIX

AIX TIME CHANGE

Discussion started by: kkeng808