_ftime_s, _ftime32_s, _ftime64_s

Article
03/26/2013

Obtient l'heure actuelle.Ce sont des versions de _ftime, _ftime32, _ftime64 avec des améliorations de sécurité comme décrit dans Fonctionnalités de sécurité du 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 _timeb,__timeb32, ou structure d' __timeb64 .

Valeur de retour

Zéro en cas de réussite, le code d'erreur en cas de échec.Si timeptr est NULL, la valeur de retour est EINVAL.

Notes

La fonction d' _ftime_s 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_s, 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_s 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_s équivaut à _ftime64_s et _timeb contient l'heure 64 bits.Cela est vrai à moins que _USE_32BIT_TIME_T défini, dans ce cas l'ancien comportement est activé ; _ftime_s utilise l'heure 32 bits et _timeb contient l'heure 32 bits.

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

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

bibliothèques

toutes les versions de 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] );
}