.TH ftime() "" "" "System Call (libc)"
.PC "Get the current time from the operating system"
.B "#include <sys/timeb.h>"
\fBint ftime(\fItbp\^\fB)\fR
\fBstruct timeb *\fItbp\^\fB;\fR
.PP
.B ftime()
fills the structure
.BR timeb ,
which is pointed to
.IR tbp ,
with \*(CO's representation of the current time.
Header file
.B timeb.h
defines
.B timeb
as follows:
.DM
struct timeb {
	time_t time;
	unsigned short millitm;
	short timezone;
	short dstflag;
}
.DE
.PP
The member
.B time
is the number of seconds since January 1, 1970, 0h00m00s GMT.
.B millitm
is a count of milliseconds.
.B timezone
and
.B dstflag
are obsolete; they have been replaced by the environmental variable
.BR TIMEZONE .
.PP
.B ftime()
does not return a meaningful value.
.SH "See Also"
.Xr "date," date
.Xr "libc," libc
.Xr "time," time
.Xr "timeb.h," timeb.h
.Xr "TIMEZONE," timezone
.Xr "types.h" types.h
.SH Notes
The ANSI Standard eliminates
.B ftime()
from the set of standard time functions.
\*(CO includes it only to support existing software.
Users are well advised to modify their time routines to eliminate
.BR ftime() .
