difftime(3)difftime(3)NAME
difftime, difftime64 - compares time values
SYNOPSIS
#include <time.h>
double difftime(
time_t time1,
time_t time2 );
The following function declaration is a Tru64 UNIX 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 fea‐
ture macro is defined during compilation. #include <time.h>
double difftime64(
time64_t time64_1,
time64_t time64_2 );
LIBRARY
Standard C Library (libc.so, libc.a)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards 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 func‐
tion declaration is only available when the _TIME64_T feature macro is
defined during compilation. See time(3) for additional details.
NOTES
The difftime() and difftime64() functions are supported for multi‐
threaded 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.
SEE ALSO
Functions: ctime(3), time(3), timezone(3)
Standards: standards(5)difftime(3)