_ftime, _ftime32, _ftime64

Artikel
06/09/2015

Rufen Sie die aktuelle Uhrzeit ab. Sicherere Versionen dieser Funktionen sind verfügbar. Informationen dazu finden Sie unter _ftime_s, _ftime32_s, _ftime64_s.

void _ftime( 
   struct _timeb *timeptr 
);
void _ftime32( 
   struct __timeb32 *timeptr 
);
void _ftime64( 
   struct __timeb64 *timeptr 
);

Parameter

timeptr
Zeiger auf _timeb,__timeb32 oder __timeb64-Struktur.

Hinweise

Die _ftime-Funktion ruft die aktuelle Ortszeit ab und fängt sie in der Struktur, die auf den durch timeptr gezeigt wird . _timeb, __timeb32 und __timeb64 werden in Strukturen SYS\Timeb.h definiert. Sie enthalten vier Felder, die in der folgenden Tabelle.

dstflag
Wert ungleich 0 (null), wenn Sommerzeit Momentan aktive für die lokale Zeitzone ist. (Siehe _tzset für dazu, wie bestimmt wird Sommerzeit.)
millitm
Sekundenbruchteil in Millisekunden.
time
Zeit in Sekunden ab Mitternacht (00:00: 00) am 1. Januar 1970 koordinierte Weltzeit (UTC).
timezone
Unterschied in Minuten, nach Westen Umstieg, zwischen UTC und Ortszeit. Der Wert timezone wird vom Wert der globalen Variable _timezone festgelegt (siehe _tzset).

_ftime64, die die __timeb64-Struktur verwendet, unterstützt von 23:59 die oben angegeben werden können, DateiErstellungsdatumsangaben: 59 3000 am 31. Dezember, UTC; während _ftime32 nur Datumsangaben von 03:14 darstellt: Am 7. Januar 19 2038, UTC. Mitternacht am 1. Januar 1970 ist die untere Begrenzung des Zeitraums für alle diese Funktionen.

_ftime entspricht _ftime64 und _timeb enthält eine 64-Bit-Zeit. Dies gilt, es sei denn, _USE_32BIT_TIME_T definiert wird, in diesem Fall das alte Verhalten gültig ist; _ftime verwendet eine 32-Bit-Zeit und _timeb enthält eine 32-Bit-Zeit.

_ftime überprüft die eigenen Parameter. Wenn es übergeben wird, ruft ein NULL-Zeiger als timeptr, die den ungültigen Parameterhandler Funktion auf, wie in Parametervalidierung beschrieben. Wenn die Ausführung zulässig ist, um fortzufahren, legt die Funktion errno auf EINVAL fest.

Anforderungen

Funktion	Erforderlicher Header
_ftime	<sys/types.h und> sys </timeb.h>
_ftime32	<sys/types.h und> sys </timeb.h>
_ftime64	<sys/types.h und> sys </timeb.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Beispiel

// crt_ftime.c
// compile with: /W3
// This program uses _ftime 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 _timeb timebuffer;
   char timeline[26];
   errno_t err;
   time_t time1;
   unsigned short millitm1;
   short timezone1;
   short dstflag1;

   _ftime( &timebuffer ); // C4996
   // Note: _ftime is deprecated; consider using _ftime_s instead

   time1 = timebuffer.time;
   millitm1 = timebuffer.millitm;
   timezone1 = timebuffer.timezone;
   dstflag1 = timebuffer.dstflag;

   printf( "Seconds since midnight, January 1, 1970 (UTC): %I64d\n", 
   time1);
   printf( "Milliseconds: %d\n", millitm1);
   printf( "Minutes between UTC and local time: %d\n", timezone1);
   printf( "Daylight savings time flag (1 means Daylight time is in "
           "effect): %d\n", dstflag1); 
   
   err = ctime_s( timeline, 26, & ( timebuffer.time ) );
   if (err)
   {
       printf("Invalid argument to ctime_s. ");
   }
   printf( "The time is %.19s.%hu %s", timeline, timebuffer.millitm,
           &timeline[20] );
}