opensolaris man page for ftime

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.11							    24 Jul 2002 							 ftime(3C)