_ftime_s, _ftime32_s, _ftime64_s

 

Date de publication : novembre 2016

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Obtient l’heure actuelle. Voici les versions de _ftime, _ftime32, _ftime64 avec des améliorations de sécurité comme décrit dans fonctionnalités de sécurité de la bibliothèque 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 un _timeb,``__timeb32, ou __timeb64 structure.

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

Le _ftime_s fonction obtient l’heure locale actuelle et le stocke dans la structure vers laquelle pointée timeptr . Le _timeb,``__timeb32, et__timeb64 structures sont définies dans SYS\Timeb.h. Elles contiennent quatre champs, qui sont répertoriées dans le tableau suivant.

dstflag
Différent de zéro si l’heure d’été est actuellement en vigueur pour le fuseau horaire local. (Voir _tzset pour une explication de la détermination de l’heure d’été.)

millitm
Fraction de seconde en millisecondes.

time
Durée en secondes écoulées depuis minuit (00 : 00:00), le 1er janvier 1970, temps universel (UTC).

timezone
Différence en minutes, le déplacement de westward, heure UTC et l’heure locale. La valeur de timezone est définie à partir de la valeur de la variable globale _timezone (voir _tzset).

_ftime64_s, qui utilise le __timeb64 de la structure, autorise les dates de création de fichiers d’exprimer à 23:59:59 le 31 décembre 3000 UTC ; alors que _ftime32_s représente uniquement les dates et 23:59:59 18 janvier 2038, UTC. Minuit, le 1er janvier 1970, est la limite inférieure de la plage de dates pour toutes ces fonctions.

_ftime_sest équivalent à _ftime64_s et _timeb contient une heure de 64 bits. Cela est vrai, sauf si _USE_32BIT_TIME_T est défini, auquel cas l’ancien comportement en vigueur ; _ ftime_s utilise une durée de 32 bits et _timeb contient une heure de 32 bits.

_ftime_svalide ses paramètres. Si passé un pointeur null en tant que timeptr, la fonction appelle le Gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. Si l’exécution est autorisée à se poursuivre, la fonction définit errno à EINVAL.

FonctionEn-tête requis
_ftime_set
_ftime32_set
_ftime64_set

Pour plus d’informations sur la compatibilité, consultez Compatibility dans l’introduction.

Toutes les versions des bibliothèques Runtime C.

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

Seconds since midnight, January 1, 1970 (UTC): 1051553334  
Milliseconds: 230  
Minutes between UTC and local time: 480  
Daylight savings time flag (1 means Daylight time is in effect): 1  
The time is Mon Apr 28 11:08:54.230 2003  

System::DateTime::Now

Gestion du temps
asctime, _wasctime
CTime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
LocalTime, _localtime32, _localtime64
heure, _time32, _time64

Afficher: