unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 ftime(2)							    ftime(2)




 NAME
      ftime - get date and time more precisely

 SYNOPSIS
      #include <&lt&lt&lt;sys/timeb.h>&gt&gt&gt;

      int ftime(struct timeb *tp);

    Remarks
      This facility is provided for backwards compatibility with Version 7
      systems.	Either time() or gettimeofday() should be used in new
      programs.

 DESCRIPTION
      ftime() fills in a structure pointed to by its argument, as defined by
      <sys/timeb.h>:

	   /*
	    * Structure returned by ftime system call
	    */
	   struct timeb {
	       time_t	      time;
	       unsigned short millitm;
	       short	      timezone;
	       short	      dstflag;
	   };

      The structure contains the time in seconds since 00:00:00 UTC
      (Coordinated Universal Time), January 1, 1970, up to 1000 milliseconds
      of more-precise interval, the local timezone (measured in minutes of
      time westward from UTC), and a flag that, if nonzero, indicates that
      Daylight Saving time applies locally during the appropriate part of
      the year.	 Consult gettimeofday(2) for more details on the meaning of
      the timezone field.

      ftime() can fail for exactly the same reasons as gettimeofday(2).

 WARNINGS
      The millisecond value usually has a granularity greater than one due
      to the resolution of the system clock.  Depending on any granularity
      (particularly a granularity of one) renders code non-portable.

 SEE ALSO
      date(1), gettimeofday(2), stime(2), time(2), ctime(3C).

 STANDARDS CONFORMANCE
      ftime(): XPG4.2







 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000