The Single UNIX ® Specification, Version 2
Copyright © 1997 The Open Group


ftime - get date and time


#include <sys/timeb.h>

int ftime(struct timeb *tp);


The ftime() function sets the time and millitm members of the timeb structure pointed to by tp to 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 contents of the timezone and dstflag members of tp after a call to ftime() are unspecified.

The system clock need not have millisecond granularity. Depending on any granularity (particularly a granularity of one) renders code non-portable.


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


No errors are defined.




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




ctime(), gettimeofday(), time(), <sys/timeb.h>.

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]