_ftime_s, _ftime32_s, _ftime64_s

Article
06/09/2015

Obtient le temps réel Il s'agit de versions de _ftime, _ftime32, _ftime64 avec des améliorations de sécurité, comme décrit dans Fonctionnalités de sécurité dans le CRT.

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

Paramètres

timeptr
Pointeur vers une structure _timeb,__timeb32, ou __timeb64

Valeur de retour

Zéro si l'opération a réussi, code d'erreur en cas de échec. Si timeptr est NULL, la valeur de retour est EINVAL.

Notes

La fonction _ftime_s 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éplacant 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).

_ftime64_s, qui utilise la structure __timeb64, permet que les dates de création de fichiers soient exprimés à 23h59 : 59, le 31 décembre, 3000, en valeurs UTC ; alors que _ftime32_s représente uniquement les dates à 3h14 : Le 7 janvier 19, 2038, en valeurs UTC. Minuit, le 1er janvier 1970, est la limite inférieure de la plage de dates pour ces deux fonctions.

_ftime_s équivaut à _ftime64_s 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_s utilise une heure 32 bits et _timeb contient une heure 32 bits.

_ftime_s 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_s	<système/types.h et> système </timeb.h>
_ftime32_s	<système/types.h et> système </timeb.h>
_ftime64_s	<système/types.h et> système </timeb.h>

Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Exemple

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