gmtime, _gmtime32, _gmtime64

Article
03/26/2013

Convertit une valeur d'heure vers une structure.plus les versions sécurisées de ces fonctions sont disponibles ; consultez gmtime_s, _gmtime32_s, _gmtime64_s.

struct tm *gmtime( 
   const time_t *timer 
);
struct tm *_gmtime32( 
   const time32_t *timer 
);
struct tm *_gmtime64( 
   const __time64_t *timer 
);

Paramètres

timer
Pointeur vers le temps stocké.L'heure est représentée sous forme de secondes écoulées depuis minuit (0h00 : 00), le 1er janvier 1970, coordinated universal time (UTC)).

Valeur de retour

Retournez plutôt un pointeur vers une structure de type le TM.Les champs de la structure retournée conservent leur valeur évaluée de l'argument d' timer dans l'heure UTC plutôt que dans le temps l'heure locale.Chacun des champs de structure est de type int, comme suit :

tm_sec
secondes après la minute (0 - 59).
tm_min
minutes après l'heure (0 - 59).
tm_hour
Heures depuis minuit (0 - 23).
tm_mday
jour du mois (1 - 31).
tm_mon
Mois (0 à 11 ; janvier = 0).
tm_year
Année (année en cours moins 1900).
tm_wday
jour de la semaine (0 - 6 ; dimanche = 0).
tm_yday
jour de l'année (0 - 365 ; 1er janvier = 0).
tm_isdst
toujours 0 pour gmtime.

Les versions 32 bits et 64 bits de gmtime, d' mktime, d' mkgmtime, et d'localtimetoute utilisation une structure unique d' tm par thread pour la conversion.Chaque appel à un de ces fonctions détruit le résultat de tout appel précédent.Si timer représente une date avant minuit, le 1er janvier 1970, gmtime retourne NULL.Il n'existe aucun retour d'erreur.

_gmtime64, qui utilise la structure d' __time64_t , accorde des dates à exprimer via le 23h59 : 59, le 31 décembre, 3000, l'heure UTC, alors qu' _gmtime32 ne représentent que les 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 ces deux fonctions.

gmtime est une fonction inline qui correspond à _gmtime64 et time_t équivaut à __time64_t.Si vous devez forcer le compilateur à interpréter time_t comme time_t32 bits ancien, vous pouvez définir _USE_32BIT_TIME_T.Cela rendra gmtime bordé dans à _gmtime32.Cela n'est pas recommandé parce que votre application peut échouer après le 18 janvier 2038, et il n'est pas autorisé sur les plateformes 64 bits.

Ces fonctions valident leurs paramètres.si timer est un pointeur null, ou si la valeur de minuterie est négative, ces fonctions appellent un gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution de se poursuivre, les fonctions NULL de retour et errno défini à EINVAL.

Notes

La fonction d' _gmtime32 détaille la valeur d' timer et le stocke dans une structure statiquement allouée de type tm, définie dans TIME.H.La valeur d' timer est généralement obtenue à partir d'un appel à la fonction d' time .

[!REMARQUE]

L'environnement cible doit essayer de déterminer si l'heure d'été est appliquée.La bibliothèque Runtime C utilise des règles des états-unis pour implémenter le calcul de l'heure d' (DST)été.

Configuration requise

routine	en-tête requis
gmtime	<time.h>
_gmtime32	<time.h>
_gmtime64	<time.h>

Pour des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.

Exemple

// crt_gmtime.c
// compile with: /W3
// This program uses _gmtime64 to convert a long-
// integer representation of coordinated universal time
// to a structure named newtime, then uses asctime to
// convert this structure to an output string.
 
#include <time.h>
#include <stdio.h>

int main( void )
{
   struct tm *newtime;
   __int64 ltime;
   char buff[80];

   _time64( &ltime );

   // Obtain coordinated universal time:
   newtime = _gmtime64( &ltime ); // C4996
   // Note: _gmtime64 is deprecated; consider using _gmtime64_s
   asctime_s( buff, sizeof(buff), newtime );
   printf( "Coordinated universal time is %s\n", buff );
}