time(3) [osf1 man page]

time(3) 						     Library Functions Manual							   time(3)

NAME

       time, time64, TIMET32TO64, TIMET64TO32 - Gets time, converts time between time_t and time64_t

LIBRARY

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

SYNOPSIS

       #include <time.h>

       time_t time(
	       time_t *tloc);

       The following data type, function declaration and macros are Compaq extensions and do not conform to current standards.	These features are
       provided to support the time64_t data type and are accessible only when the _TIME64_T feature macro is defined during compilation.

       #include <time.h>

       typedef long time64_t;

       time64_t time64(
	       time64_t *tloc64);

       void TIMET32TO64(t32, t64)

       int TIMET64TO32(t64, t32)

PARAMETERS

       Points to the location where the return value of type time_t is stored. When this parameter is a null pointer, no value is stored.   Points
       to  the location where the return value of type time64_t is stored. When this parameter is a null pointer, no value is stored.  Refers to a
       variable of type time_t.  Refers to a variable of type time64_t.

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.

       The  time64_t  data  type  is  a  64-bit signed value which, like the 32-bit time_t data type, is defined as the "time in seconds since the
       Epoch."	It is provided for storage and manipulation of times beyond the range of a 32-bit time_t (Dec 13 20:45:52 GMT 1901 through Jan	19
       03:14:07 GMT 2038).  This data type is only available when the _TIME64_T feature macro is defined during compilation.

       The time64() function works exactly as the time() function, but uses the larger time64_t type (referenced by the tloc64 pointer) instead of
       time_t.	The current system time setting limits (Jan 1 00:00:00 GMT 1970 through Jan 19 03:14:07 GMT 2038) are not changed by this function
       or the time64_t data type.  This function declaration is only available when the _TIME64_T feature macro is defined during compilation.

       The  TIMET32TO64()  and	TIMET64TO32() macros are provided to assist developers converting between values of type time_t and values of type
       time64_t.  The TIMET32TO64() macro converts the value contained in t32 to a value of type time64_t and stores the result in t64, performing
       sign-extension  as  appropriate.  The TIMET64TO32() macro attempts to convert the value contained in t64 to a value of type time_t, storing
       the result in t32. If the value of t64 overflows the size of a time_t, the value of the TIMET64TO32() macro will be 1 and the value of  t32
       is undefined. Otherwise, the value of the TIMET64TO32() macro will be 0 and t32 will contain the converted value from t64. These conversion
       macros are only available when the _TIME64_T feature macro is defined during compilation.

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.

       Upon  successful completion, the time64() function returns the value of time in seconds since the Epoch.  Otherwise, the value (time64_t)-1
       is returned.

RELATED INFORMATION

       Functions: gettimeofday(2), clock(3), ctime(3), difftime(3), stime(3), strftime(3), strptime(3)

       Standards: standards(5) delim off

																	   time(3)

Check Out this Related Man Page

difftime(3)						     Library Functions Manual						       difftime(3)

NAME

       difftime, difftime64 - Compares time values

LIBRARY

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

SYNOPSIS

       #include <time.h>

       double difftime(
	       time_t time1,
	       time_t time2);

       The  following  function  declaration is a Compaq extension and does not conform to current standards. This function is provided to support
       the time64_t data type and is accessible only when the _TIME64_T feature macro is defined during compilation.  #include <time.h>

       double difftime64(
	       time64_t time64_1,
	       time64_t time64_2);

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       difftime():  XPG4, XPG4-UNIX

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Specifies a time value of type time_t expressed in seconds.  Specifies a time value of type time_t expressed in seconds.  Specifies a  time
       value of type time64_t expressed in seconds.  Specifies a time value of type time64_t expressed in seconds.

DESCRIPTION

       The difftime() function returns a signed time value in seconds that is the difference between the values of the time1 and time2 parameters,
       also expressed in seconds.

       The difftime64() function works exactly as the difftime() function, but accepts arguments of type time64_t type instead	of  time_t.   This
       function  declaration  is only available when the _TIME64_T feature macro is defined during compilation. See the time(3) reference page for
       additional details.

NOTES

       The difftime() and difftime64() functions are supported for multithreaded applications.

RETURN VALUES

       Upon successful completion the difftime() function returns a value, expressed in seconds, that is the  difference  between  the	values	of
       parameters time1 and time2.

       Upon  successful  completion  the  difftime64() function returns a value,expressed in seconds, that is the difference between the values of
       parameters time64_1 and time64_2.

RELATED INFORMATION

       Functions: ctime(3), time(3), timezone(3)

       Standards: standards(5) delim off

																       difftime(3)

Linux and UNIX Man Pages

time(3) [osf1 man page]

Check Out this Related Man Page