_ftime, _ftime32, _ftime64

Article
06/09/2015

Obtient l'heure actuelle. Des versions plus 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 une structure _timeb,__timeb32 ou __timeb64 .

Notes

La fonction _ftime obtient l'heure locale actuelle et la stocke dans la structure désignée par timeptr*.* Les structures _timeb, __timeb32,et__timeb64 sont définies dans SYS\Timeb.h. Ils contiennent quatre champs, répertoriés dans le tableau suivant.

dstflag
Une valeur différente de zéro si l'heure d'été est actuellement en vigueur pour le fuseau horaire local. (Voir _tzset pour obtenir des explications sur la manière dont 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, temps universel coordonné (UTC).
timezone
Différence en minutes, en se déplaçant vers l'ouest, entre UTC et l'heure locale. La valeur timezone est définie à partir de la valeur de la variable globale _timezone (voir _tzset).

_ftime64qui utilise la structure __timeb64, permet que les dates de création de fichiers soient exprimés jusqu'à 23:59:59, le 31 décembre, 3000, UTC ; alors que _ftime32 représente uniquement les dates jusqu'à 03:14:07 Le 19 janvier, 2038, UTC. Minuit, le 1er janvier 1970, est la limite inférieure de la plage de dates pour ces deux fonctions.

_ftime équivaut à _ftime64 et _timeb contient une heure 64 bits. Ceci s'applique à moins que _USE_32BIT_TIME_T ne soit défini, auquel cas le comportement antérieur est appliqué ; _ftime utilise une heure 32 bits et _timeb contient une heure 32 bits.

_ftime valide ses paramètres. Si timeptr est un pointeur null, la fonction appelle le gestionnaire de paramètres invalides comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, la fonction retourne -1 et définit errno avec la valeur EINVAL.

Configuration requise

Fonction	En-tête requis
_ftime	<système/types.h et> système </timeb.h>
_ftime32	<système/types.h et> système </timeb.h>
_ftime64	<système/types.h et> système </timeb.h>

Pour plus d'informations sur la 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] );
}