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)