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)