Funzione libreria C - gmtime ()

Descrizione

La funzione di libreria C. struct tm *gmtime(const time_t *timer) usa il valore indicato dal timer per riempire un file tm struttura con i valori che rappresentano l'ora corrispondente, espressa in Coordinated Universal Time (UTC) o fuso orario GMT.

Dichiarazione

Di seguito è riportata la dichiarazione per la funzione gmtime ().

struct tm *gmtime(const time_t *timer)

Parametri

  • timeptr - Questo è il puntatore a un valore time_t che rappresenta l'ora del calendario.

Valore di ritorno

Questa funzione restituisce il puntatore a una struttura tm con le informazioni sull'ora inserite. Di seguito è riportato il dettaglio della struttura 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             */	
};

Esempio

L'esempio seguente mostra l'utilizzo della funzione 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);
}

Compiliamo ed eseguiamo il programma sopra che produrrà il seguente risultato:

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