ftime(2)

NAME

ftime − get date and time more precisely

SYNOPSIS

#include <sys/timeb.h>

int ftime(struct timeb *tp);

REMARKS

This facility is provided for backwards compatibility with Version 7 systems. Either time() or gettimeofday() should be used in new programs.

DESCRIPTION

ftime() fills in a structure pointed to by its argument, as defined by <sys/timeb.h>:

/*
* Structure returned by ftime system call
*/
struct timeb {
    time_ttime;
    unsigned short millitm;
    shorttimezone;
    shortdstflag;
};

The structure contains the time in seconds since 00:00:00 UTC (Coordinated Universal Time), January 1, 1970, up to 1000 milliseconds of more-precise interval, the local timezone (measured in minutes of time westward from UTC), and a flag that, if nonzero, indicates that Daylight Saving time applies locally during the appropriate part of the year. Consult gettimeofday(2) for more details on the meaning of the timezone field.

This function can be accessed by giving the -lV7 option to the ld command (see ld(1)).

ftime() can fail for exactly the same reasons as gettimeofday(2).

WARNINGS

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.

Hewlett-Packard Company — HP-UX Release 10.20: July 1996

Museum