opensolaris man page for ftime

Query: ftime

OS: opensolaris

Section: 3c

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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)
Related Man Pages
ftime(3) - linux
ftime(3) - debian
ftime(3c) - sunos
ftime(3) - posix
ftime(3) - opendarwin
Similar Topics in the Unix Linux Community
changing sys clock (PST to UTC)
If condition not working
Oroboros 20080505 (Default branch)
Oroboros 20080711 (Default branch)
Reading Daylight Saving Time in Linux using C/C++