Partager via


_ftime_s, _ftime32_s, _ftime64_s

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

Équivalent .NET Framework

System.DateTime

Voir aussi

Référence

Gestion du temps

asctime, _wasctime

ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

gmtime, _gmtime32, _gmtime64

localtime, _localtime32, _localtime64

time, _time32, _time64