gmtime64() — 変換時間

オンライン編集

形式

#include <time.h>
struct tm *gmtime64(const time64_t *time);

言語レベル

ILE C Extension

スレッド・セーフ

いいえ

代わりに gmtime64_r() を使用します。

説明

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

tm 構造体のフィールドには、以下のものがあります。
tm_sec
秒 (0 から 61)
tm_min
分 (0 から 59)
tm_hour (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) が有効な場合は正の値。情報が使用可能でない場合は負の値。

戻り値

gmtime64() 関数は、結果である tm 構造体へポインターを戻します。
注:
  1. tm_sec の範囲 (0 から 61) は、2 うるう秒までを考慮に入れています。
  2. gmtime64() および localtime64() 関数は、静的に割り振られた共通のバッファーを変換に使用します。 これらの関数の 1 つを呼び出すごとに、以前の呼び出しの結果を変更します。 asctime_r()、ctime64_r()、gmtime64_r()、および localtime64_r() 関数は、戻りストリングの保持用に静的に割り振られた共通のバッファーを使用しません。 これらの関数は、再入可能性が望ましい場合に、asctime()、ctime64()、gmtime64()、および localtime64() 関数の代わりに使用可能です。
  3. カレンダー時間とは、エポックである UTC (1970 年 1 月 1 日 00:00:00) から数えた秒数です。

例

この例では、 gmtime64() 関数を使用して time64_t 表現を協定世界時の文字ストリングに調整し、 asctime() 関数を使用してそれを印刷可能ストリングに変換します。
#include <stdio.h>
#include <time.h>
 
int main(void)
{
   time64_t ltime;
 
   time64(&ltime);
   printf ("Universal Coordinate Time is %s",
   asctime(gmtime64(&ltime)));
}
 
/************************  Output should be similar to:  **********
 
Universal Coordinate Time is Wed Aug 18 21:01:44 1993
*/

関連情報