_ftime_s, _ftime32_s, _ftime64_s

Ruft die aktuelle Zeit ab Diese Funktionen sind Versionen von _ftime, _ftime32_ftime64 mit Sicherheitsverbesserungen, wie in sicherheitsfeatures im CRT beschrieben.

Syntax

errno_t _ftime_s( struct _timeb *timeptr );
errno_t _ftime32_s( struct __timeb32 *timeptr );
errno_t _ftime64_s( struct __timeb64 *timeptr );

Parameter

timeptr
Zeiger auf ein , __timeb32oder __timeb64 eine _timebStruktur.

Rückgabewert

Null, wenn erfolgreich, Fehlercode bei Fehler. Wenn timeptrNULL ist, wird EINVAL zurückgegeben.

Hinweise

Die _ftime_s Funktion ruft die aktuelle Ortszeit ab und speichert sie in der Struktur, auf timeptrdie verwiesen wird. Die _timebStrukturen __timeb32und __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. (Hier finden Sie _tzset eine Erläuterung, 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_s Funktion, die die __timeb64 Struktur verwendet, ermöglicht die Darstellung von Dateierstellungsdaten bis 23:59:59, 31. Dezember 3000, UTC; während _ftime32_s nur Datumsangaben bis 23:59:59 Januar 18, 2038, UTC dargestellt werden. Der 1. Januar 1970 (Mitternacht) ist der älteste mögliche Datumsbereich für all diese Funktionen.

Die _ftime_s Funktion entspricht _ftime64_sder 64-Bit-Zeit und _timeb enthält eine 64-Bit-Zeit, es sei denn _USE_32BIT_TIME_T , das alte Verhalten ist in Kraft; _ftime_s verwendet eine 32-Bit-Zeit und _timeb enthält eine 32-Bit-Zeit.

_ftime_s überprüft die eigenen Parameter. Wenn ein NULL-Zeiger als übergeben wird timeptr, 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 im Global state in the CRT.

Anforderungen

Funktion	Erforderlicher Header
_ftime_s	<sys/types.h> und <sys/timeb.h>
_ftime32_s	<sys/types.h> und <sys/timeb.h>
_ftime64_s	<sys/types.h> und <sys/timeb.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Bibliotheken

Alle Versionen der C-Laufzeitbibliotheken.

Beispiel

// crt_ftime64_s.c
// This program uses _ftime64_s 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;

   _ftime64_s( &timebuffer );

    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