Index for Section 3

Alphabetical listing for D

Bottom of page

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 feature 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 standards
  as follows:

  difftime():  XPG4, XPG4-UNIX

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

PARAMETERS
  time1
      Specifies a time value of type time_t expressed in seconds.

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

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

  time64_2
      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 time(3) 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.

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

  Standards: standards(5)

Index for Section 3

Alphabetical listing for D

Top of page