_ftime, _ftime32, _ftime64

Article
03/26/2013

Obtenez l'heure actuelle.plus les versions sécurisées de ces fonctions sont disponibles ; consultez _ftime_s, _ftime32_s, _ftime64_s.

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

Paramètres

timeptr
Pointeur vers _timeb,à__timeb32 ou à la structure d' __timeb64 .

Notes

La fonction d' _ftime obtient l'heure locale actuelle et l'enregistre dans la structure désignée par timeptr*.*_timeb, __timeb32,les structures etd'__timeb64 sont définis dans le système \Timeb .h.Il contient quatre champs, répertoriés dans le tableau suivant.

dstflag
Une valeur différente de zéro si l'heure d'été est actuellement appliqué pour le fuseau horaire local.(Consultez _tzset pour une explication du fonctionnement de l'heure d'été est déterminée.)
millitm
Fraction de seconde en millisecondes.
time
Durée en secondes depuis minuit (0h00 : 00), le 1er janvier 1970, coordinated universal time (UTC)).
timezone
Différence en minutes, déplace vers l'ouest, entre l'heure UTC et l'heure locale.la valeur d' timezone est définie de la valeur de la variable globale _timezone (voir l' _tzset).

_ftime64, qui utilise la structure d' __timeb64 , accorde les dates de fichier-création à exprimer via le 23h59 : 59, le 31 décembre, 3000, l'heure UTC ; alors qu' _ftime32 représente uniquement des dates via le 3h14 : Le 7 janvier 19, 2038, l'heure UTC.Minuit, le 1er janvier 1970, correspond à la limite inférieure de la plage de dates pour toutes ces fonctions.

_ftime équivaut à _ftime64 et _timeb contient l'heure 64 bits.Cela est vrai à moins qu' _USE_32BIT_TIME_T défini, dans ce cas l'ancien comportement est activé ; _ftime utilise l'heure 32 bits et _timeb contient l'heure 32 bits.

_ftime valide ses paramètres.si passé un pointeur null comme timeptr, la fonction appelle le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, la fonction définit errno à EINVAL.

Configuration requise

Fonction	en-tête requis
_ftime	<sys/types.h> et <sys/timeb.h>
_ftime32	<sys/types.h> et <sys/timeb.h>
_ftime64	<sys/types.h> et <sys/timeb.h>

Pour plus d'informations de compatibilité, consultez compatibilité dans l'introduction.

Exemple

// 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] );
}