ftime(3c) [opensolaris man page]

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)

FTIME(3)						     Linux Programmer's Manual							  FTIME(3)

NAME

       ftime - return date and time

SYNOPSIS

       #include <sys/timeb.h>

       int ftime(struct timeb *tp);

DESCRIPTION

       This  function returns the current time as seconds and milliseconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).  The time is returned
       in tp, which is declared as follows:

	   struct timeb {
	       time_t	      time;
	       unsigned short millitm;
	       short	      timezone;
	       short	      dstflag;
	   };

       Here time is the number of seconds since the Epoch, and millitm is the number of milliseconds since time  seconds  since  the  Epoch.   The
       timezone field is the local timezone measured in minutes of time west of Greenwich (with a negative value indicating minutes east of Green-
       wich).  The dstflag field is a flag that, if nonzero, indicates that Daylight Saving time applies locally during the  appropriate  part	of
       the year.

       POSIX.1-2001 says that the contents of the timezone and dstflag fields are unspecified; avoid relying on them.

RETURN VALUE

       This function always returns 0.	(POSIX.1-2001 specifies, and some systems document, a -1 error return.)

ATTRIBUTES

       For an explanation of the terms used in this section, see attributes(7).

       +----------+---------------+---------+
       |Interface | Attribute	  | Value   |
       +----------+---------------+---------+
       |ftime()   | Thread safety | MT-Safe |
       +----------+---------------+---------+
CONFORMING TO

       4.2BSD, POSIX.1-2001.  POSIX.1-2008 removes the specification of ftime().

       This  function  is  obsolete.   Don't  use  it.	 If the time in seconds suffices, time(2) can be used; gettimeofday(2) gives microseconds;
       clock_gettime(2) gives nanoseconds but is not as widely available.

BUGS

       Early glibc2 is buggy and returns 0 in the millitm field; glibc 2.1.1 is correct again.

SEE ALSO

       gettimeofday(2), time(2)

COLOPHON

       This page is part of release 4.15 of the Linux man-pages project.  A description of the project, information about reporting bugs, and  the
       latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.

GNU
								    2017-09-15								  FTIME(3)