RAD Studio
ContentsIndex
PreviousUpNext
ftime

Header File 

sys\timeb.h  

Category 

Time and Date Routines 

Prototype 

void ftime(struct timeb *buf) 

Description 

Stores current time in timeb structure. 

On UNIX platforms ftime is available only on System V systems. 

ftime determines the current time and fills in the fields in the timeb structure pointed to by buf. The timeb structure contains four fields: time, millitm, _timezone, and dstflag: 

struct timeb { 

long time ; 

short millitm ; 

short _timezone ; 

short dstflag ; 

};

  • timeprovides the time in seconds since 00:00:00 Greenwich mean time (GMT) January 1 1970.
  • millitmis the fractional part of a second in milliseconds.
  • _timezoneis the difference in minutes between GMT and the local time. This value is computed going west from GMT. ftime gets this field from the global variable _timezone which is set by tzset.
  • dstflagis set to nonzero if daylight saving time is taken into account during time calculations.
Note: ftime calls tzset. Therefore it isn't necessary to call tzset explicitly when you use ftime.
Return Value 

None. 

Example  

#include <stdio.h>
#include <stdlib.h>
#include <time.h>
#include <sys\timeb.h>
/* pacific standard & daylight savings */
char *tzstr = "TZ=PST8PDT";
int main(void)
{
   struct timeb t;
   putenv(tzstr);
   tzset();
   ftime(&t);
   printf("Seconds since 1/1/1970 GMT: %ld\n", t.time);
   printf("Thousandths of a second: %d\n", t.millitm);
   printf("Difference between local time and GMT: %d\n", t._timezone);
   printf("Daylight savings in effect (1) not (0): %d\n", t.dstflag);
   return 0;
}

Portability

POSIX 
Win32 
ANSI C 
ANSI C++ 
 
 
 
Copyright(C) 2008 CodeGear(TM). All Rights Reserved.
What do you think about this topic? Send feedback!