_ftime, _ftime64
Collapse the table of content
Expand the table of content
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

_ftime, _ftime64

Get the current time.

void _ftime( 
   struct _timeb *timeptr 
void _ftime64( 
   struct __timeb64 *timeptr 


Pointer to a _timeb or __timeb64 structure.


The _ftime function gets the current local time and stores it in the structure pointed to by timeptr. The _timeb structure is defined in SYS\TIMEB.H. It contains four fields:

Nonzero if daylight savings time is currently in effect for the local time zone. (See _tzset for an explanation of how daylight savings time is determined.)
Fraction of a second in milliseconds.
Time in seconds since midnight (00:00:00), January 1, 1970, coordinated universal time (UTC).
Difference in minutes, moving westward, between UTC and local time. The value of timezone is set from the value of the global variable _timezone (see _tzset).

_ftime64, which uses the __timeb64 structure, allows file-creation dates to be expressed up through 23:59:59, December 31, 3000, UTC, whereas _ftime only represents dates through 19:14:07 January 18, 2038, UTC. Midnight, January 1, 1970, is the lower bound of the date range for all these functions.


Function Required header Compatibility
_ftime <sys/types.h> and <sys/timeb.h> Win 98, Win Me, Win NT, Win 2000, Win XP
_ftime64 <sys/types.h> and <sys/timeb.h> Win 98, Win Me, Win NT, Win 2000, Win XP

For additional compatibility information, see Compatibility in the Introduction.


All versions of the C run-time libraries.


// crt_ftime.c
/* This program uses _ftime64 to obtain the current
 * time and then stores this time in timebuffer.

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

int main( void )
   struct __timeb64 timebuffer;
   char *timeline;

   _ftime64( &timebuffer );
   timeline = _ctime64( & ( timebuffer.time ) );

   printf( "The time is %.19s.%hu %s", timeline, timebuffer.millitm, &timeline[20] );

Sample Output

The time is Wed Feb 13 09:01:26.729 2002

See Also

Time Management Routines | asctime | ctime | gmtime | localtime | time | Run-Time Routines and .NET Framework Equivalents

© 2016 Microsoft