gmtime() - C語言庫函式


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