Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Standard C Library Functionsftime(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.

SEE ALSO

 

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


SunOS 5.9Go To TopLast Changed 4 Mar 1996

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.