ftime(3) [osx man page]

FTIME(3)						   BSD Library Functions Manual 						  FTIME(3)

NAME

     ftime -- get date and time

SYNOPSIS

     #include <sys/timeb.h>

     int
     ftime(struct timeb *tp);

DESCRIPTION

     This interface is obsoleted by gettimeofday(2).

     The ftime() routine 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 since the epoch, in seconds; up to 1000 milliseconds of more-precise interval; the local time zone (measured
     in minutes of time westward from Greenwich); and a flag that, if nonzero, indicates that Daylight Saving time applies locally during the
     appropriate part of the year.

LEGACY SYNOPSIS

     #include <sys/types.h>
     #include <sys/timeb.h>

     The include file <sys/types.h> is necessary.

SEE ALSO

     gettimeofday(2), settimeofday(2), ctime(3), time(3), compat(5)

HISTORY

     The ftime function appeared in 4.2BSD.

BSD
								   June 4, 1993 							       BSD

ftime(3C)						   Standard C Library Functions 						 ftime(3C)

NAME

       ftime - get date and time

SYNOPSIS

       #include <sys/timeb.h>

       int ftime(struct timeb *tp);

DESCRIPTION

       The  ftime()  function sets the time and millitm members of the timeb structure pointed to by tp. The structure is defined in <sys/timeb.h>
       and contains the following members:

       time_t		time;
       unsigned short	millitm;
       short		timezone;
       short		dstflag;

       The time and millitm members contain the seconds and milliseconds portions, respectively, of the current time in seconds since 00:00:00 UTC
       (Coordinated Universal Time), January 1, 1970.

       The timezone member contains the local time zone. The dstflag member contains a flag that, if non-zero, indicates that Daylight Saving time
       applies locally during the appropriate part of the year.

       The contents of the timezone and dstflag members of tp after a call to ftime() are unspecified.

RETURN VALUES

       Upon successful completion, the ftime() function returns 0. Otherwise -1 is returned.

ERRORS

       No errors are defined.

USAGE

       For portability to implementations conforming to earlier versions of this document, time(2) is preferred over this function.

       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.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       date(1), time(2), ctime(3C), gettimeofday(3C), timezone(4), attributes(5), standards(5)

SunOS 5.10							    24 Jul 2002 							 ftime(3C)