Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 por-
       tions, 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 (par-
       ticularly 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),   at-
       tributes(5), standards(5)

SunOS 5.10			  24 Jul 2002			     ftime(3C)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | USAGE | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ftime&sektion=3c&manpath=SunOS+5.10>

home | help