ftime()

get the current time, and store it in a structure

Synopsis:

#include <sys/timeb.h>
int ftime( struct timeb *timeptr );

Description:

The ftime() function gets the current time and stores it in the structure pointed to by timeptr. This timeb structure contains the following fields:

time_t time

time in seconds since Jan 1, 1970 UTC

unsigned short millitm

milliseconds

short timezone

difference in minutes from UTC

short dstflag

nonzero if in daylight savings time

Returns:

-1

Failure

Any other value

Success

Examples:

#include <stdio.h>
#include <time.h>
#include <sys/timeb.h>

void main()
  {
    struct timeb timebuf;
    char   *tod;

    ftime( &timebuf );
    tod = ctime( &timebuf.time );
    printf( "The time is %.19s.%hu %s",
      tod, timebuf.millitm, &tod[20] );
  }

produces output similar to the following:

The time is Tue Dec 25 15:58:42.870 1990

Classification:

WATCOM

See also:

asctime(), clock(), ctime(), difftime(), gmtime(), localtime(), mktime(), strftime(), time(), tzset()