Fonction de bibliothèque C - gmtime ()

La description

La fonction de bibliothèque C struct tm *gmtime(const time_t *timer) utilise la valeur pointée par timer pour remplir un tm structure avec les valeurs qui représentent l'heure correspondante, exprimée en temps universel coordonné (UTC) ou fuseau horaire GMT.

Déclaration

Voici la déclaration de la fonction gmtime ().

struct tm *gmtime(const time_t *timer)

Paramètres

• timeptr - Il s'agit du pointeur vers une valeur time_t représentant une heure du calendrier.

Valeur de retour

Cette fonction renvoie le pointeur vers une structure tm avec les informations de temps renseignées. Ci-dessous se trouve le détail de la structure timeptr -

struct tm {
   int tm_sec;         /* seconds,  range 0 to 59          */
   int tm_min;         /* minutes, range 0 to 59           */
   int tm_hour;        /* hours, range 0 to 23             */
   int tm_mday;        /* day of the month, range 1 to 31  */
   int tm_mon;         /* month, range 0 to 11             */
   int tm_year;        /* The number of years since 1900   */
   int tm_wday;        /* day of the week, range 0 to 6    */
   int tm_yday;        /* day in the year, range 0 to 365  */
   int tm_isdst;       /* daylight saving time             */	
};

Exemple

L'exemple suivant montre l'utilisation de la fonction gmtime ().

#include <stdio.h>
#include <time.h>

#define BST (+1)
#define CCT (+8)

int main () {

   time_t rawtime;
   struct tm *info;

   time(&rawtime);
   /* Get GMT time */
   info = gmtime(&rawtime );
   
   printf("Current world clock:\n");
   printf("London : %2d:%02d\n", (info->tm_hour+BST)%24, info->tm_min);
   printf("China  : %2d:%02d\n", (info->tm_hour+CCT)%24, info->tm_min);

   return(0);
}

Compilons et exécutons le programme ci-dessus qui produira le résultat suivant -

Current world clock:
London : 14:10
China : 21:10