C庫函數 struct tm *gmtime(const time_t *timer) 使用定時器所指向的數值，以填補atm結構的值，表示對應的時間，以協調通用時間（UTC）或GMT時區表示。

聲明

以下是gmtime() 函數的聲明。

struct tm *gmtime(const time_t *timer)

參數

• timeptr -- 這是一個time_t值表示日曆時間的指針。

返回值

這個函數返回指向tm結構和下麵的時間信息填寫。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             */	
};

例子

下麵的例子顯示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:
");
   printf("London : %2d:%02d
", (info->tm_hour+BST)%24, info->tm_min);
   printf("China  : %2d:%02d
", (info->tm_hour+CCT)%24, info->tm_min);

   return(0);
}

讓我們編譯和運行上麵的程序，這將產生以下結果：

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