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(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
SEE ALSO
date(1),
time(2),
ctime(3C),
gettimeofday(3C),
timezone(5),
attributes(7),
standards(7) July 24, 2002 FTIME(3C)
