Content-type: text/html Man page of ftime

ftime

Section: Standard C Library Functions (3C)
Updated: 24 Jul 2002
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE
Interface StabilityStandard

 

SEE ALSO

date(1), time(2), ctime(3C), gettimeofday(3C), timezone(4), attributes(5), standards(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
USAGE
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:37:19 GMT, October 02, 2010