_ftime, _ftime32, _ftime64

Ruft die aktuelle Zeit ab Sicherere Versionen dieser Funktionen sind verfügbar; siehe _ftime_s, , _ftime64_s. _ftime32_s

Syntax

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

Parameter

timeptr
Zeiger auf eine _timeb, __timeb32oder __timeb64 struktur.

Bemerkungen

Die Funktion _ftime ruft die aktuelle, lokale Zeit ab und speichert sie in der Struktur, auf die timeptr zeigt. Die _timeb, __timeb32, und __timeb64 Strukturen werden in <sys\timeb.h> definiert. Sie enthalten vier Felder, die in der folgenden Tabelle aufgeführt werden.

Feld BESCHREIBUNG
dstflag Ein Wert ungleich null, wenn die Sommerzeit zurzeit für die lokale Zeitzone gültig ist. (Siehe _tzset eine Erklärung, wie Die Sommerzeit bestimmt wird.)
millitm Sekundenbruchteile in Millisekunden
time Die Zeit in Sekunden seit dem 1. Januar 1970, Mitternacht (00: 00: 00) im UTC-Format
timezone Differenz in Minuten, westwärts zwischen UTC und der Ortszeit Der Wert timezone wird aus dem Wert der globalen Variablen _timezone festgelegt (siehe _tzset).

Die _ftime64 Funktion, die die __timeb64 Struktur verwendet, ermöglicht die Erstellung von Dateien bis 23:59:59, 31. Dezember 31, 3000, UTC; in der _ftime32 Erwägung, dass nur Datumsangaben bis 23:59. Januar 18, 2038, UTC dargestellt werden. Der 1. Januar 1970 (Mitternacht) ist der älteste mögliche Datumsbereich für beide Funktionen.

Die _ftime Funktion entspricht , und _timeb enthält eine 64-Bit-Zeit, es sei _USE_32BIT_TIME_T denn, das alte Verhalten ist _ftime64wirksam. _ftime Verwendet eine 32-Bit-Zeit und _timeb enthält eine 32-Bit-Zeit.

_ftime überprüft die eigenen Parameter. Wenn ein Nullzeiger als timeptrübergeben wurde, ruft die Funktion den ungültigen Parameterhandler auf, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, legt die Funktion errno auf EINVAL fest.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie unter "Globaler Zustand" im CRT.

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 Compatibility.

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] );
}
Seconds since midnight, January 1, 1970 (UTC): 1051553334
Milliseconds: 230
Minutes between UTC and local time: 480
Daylight savings time flag (1 means Daylight time is in effect): 1
The time is Mon Apr 28 11:08:54.230 2003

Siehe auch

Zeitverwaltung
asctime, _wasctime
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
time, _time32, _time64