x SuSE Linux 13.1-RELEASE x x SuSE Linux 13.1-RELEASEx ftime(3) Library Functions Manual ftime(3) NAME ftime - return date and time LIBRARY Standard C library (libc, -lc) SYNOPSIS #include <sys/timeb.h> int ftime(struct timeb *tp); DESCRIPTION NOTE: This function is no longer provided by the GNU C library. Use clock_gettime(2) instead. 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 time- zone field is the local timezone measured in minutes of time west of Greenwich (with a negative value indicating minutes east of Greenwich). 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 sys- tems document, a -1 error return.) ATTRIBUTES For an explanation of the terms used in this section, see at- tributes(7). +--------------------------------------------+---------------+---------+ |Interface | Attribute | Value | +--------------------------------------------+---------------+---------+ |ftime() | Thread safety | MT-Safe | +--------------------------------------------+---------------+---------+ STANDARDS None. HISTORY Removed in glibc 2.33. 4.2BSD, POSIX.1-2001. Removed in POSIX.1-2008. This function is obsolete. Don't use it. If the time in seconds suf- fices, 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) Linux man-pages 6.04 2023-03-30 ftime(3)
Want to link to this manual page? Use this URL:
<http://star2.abcm.com/cgi-bin/bsdi-man?query=ftime&sektion=3&manpath=>