_ftime, _ftime64
Visual Studio .NET 2003
Get the current time.
void _ftime( struct _timeb *timeptr ); void _ftime64( struct __timeb64 *timeptr );
Parameter
- timeptr
- Pointer to a _timeb or __timeb64 structure.
Remarks
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:
- dstflag
- 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.)
- millitm
- Fraction of a second in milliseconds.
- time
- Time in seconds since midnight (00:00:00), January 1, 1970, coordinated universal time (UTC).
- timezone
- 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.
Requirements
| 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.
Libraries
All versions of the C run-time libraries.
Example
// 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
