NAME    [Toc]    [Back]

       difftime, difftime64 - compares time values

SYNOPSIS    [Toc]    [Back]

       #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  feature  macro  is
       defined during compilation.  #include <time.h>

       double difftime64(
               time64_t time64_1,
               time64_t time64_2 );

LIBRARY    [Toc]    [Back]

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

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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 time(3) for additional details.

NOTES    [Toc]    [Back]

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

RETURN VALUES    [Toc]    [Back]

       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    [Toc]    [Back]

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

       Standards: standards(5)



                                                      difftime(3)