gmtime() — 時間の変換

フォーマット 

#include <time.h>
struct tm *gmtime(const time_t *time);

言語レベル: ANSI

スレッド・セーフ: いいえ。代わりに gmtime_r() を使用します。

説明

gmtime() 関数は、time 値を秒単位で分割し、<time.h> で定義された tm 構造体に保管します。 time の値は、通常、time() 関数を呼び出して取得します。

tm 構造体のフィールドには、以下のものがあります。

tm_sec
秒 (0 から 61)
tm_min
分 (0 から 59)
tm_hour
時間 (0 から 23)
tm_mday
日 (1 から 31)
tm_mon
月 (0 から 11、1 月が 0 になる)
tm_year
年 (現在の年から 1900 を差し引く)
tm_wday
曜日 (0 から 6、日曜日が 0 になる)
tm_yday
ユリウス日付 (0 から 365、1 月 1 日が 0 になる)
tm_isdst
夏時間 (DST) が無効な場合は 0。夏時間 (DST) が有効な場合は正の値。情報が使用可能でない場合は負の値。

戻り値

gmtime() 関数は、結果である tm 構造体へポインターを戻します。

注:
  1. tm_sec の範囲 (0 から 61) は、2 うるう秒までを考慮に入れています。
  2. gmtime() および localtime() 関数は、静的に割り振られた共通のバッファーを変換に使用します。 これらの関数の 1 つを呼び出すごとに、以前の呼び出しの結果を変更します。
  3. カレンダー時間とは、エポックである UTC (1970 年 1 月 1 日 00:00:00) から数えた秒数です。

gmtime() の使用例

この例では、gmtime() 関数を使用して time_t 表記を協定世界時 (UTC) 文字ストリングへ調整し、次にそれを asctime() 関数を使用して出力可能なストリングに変換します。 

#include <stdio.h>
#include <time.h>
 
int main(void)
{
   time_t ltime;
 
      time(&ltime);
		printf ("Coordinated Universal Time is %s\n",
            asctime(gmtime(&ltime)));
}
 
/************************  Output should be similar to:  **********
 
Coordinated Universal Time is Wed Aug 18 21:01:44 1993
*/

関連情報


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]