ftime(3) [netbsd man page]

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

NAME

     ftime -- get date and time

LIBRARY

     Compatibility Library (libcompat, -lcompat)

SYNOPSIS

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

     int
     ftime(struct timeb *tp);

DESCRIPTION

     This interface is obsoleted by gettimeofday(2).  It is available from the compatibility library, libcompat.

     Note: time zone information is no longer provided by this interface.  See localtime(3) for information on how to retrieve it.

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

	   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 timezone and dstflag
     fields are provided for source compatibility, but are always zero.

SEE ALSO

     gettimeofday(2), settimeofday(2), ctime(3), localtime(3), time(3)

HISTORY

     The ftime() function appeared in 4.1BSD.

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)