ftime() - 日時の設定

標準

標準/拡張機能	C/C++	依存項目
XPG4.2 Single UNIX Specification、バージョン 3	両方

形式

#define _XOPEN_SOURCE_EXTENDED 1
#include <sys/timeb.h>

int ftime(struct timeb *tp);

機能説明

ftime() 関数は、tp が指す timeb 構造体の time メンバーと millitm メンバーに、協定世界時 (UTC) 1970 年 1 月 1 日 00:00:00 以降の秒数で表された現在の時刻の秒数とミリ秒数をそれぞれ設定します。

注: ftime() 関数は Single UNIX Specification、バージョン 3 のレガシー・オプション・グループに既に移動されていて、将来のバージョンで廃止する可能性があります。移植性の観点からは、time() 関数が推奨されます。

戻り値

正常に実行された場合、ftime() は 0 を戻します。

オーバーフローが発生した場合、ftime() は -1 を戻します。

¹

関連情報

¹ オーバーフローが発生するのは、1970 年 1 月 1 日、00:00:00 UTC 以降の秒数で表された現在の時刻が、tp の指す timeb 構造体の time メンバーの容量を超えたときです。time メンバーは、型 time_t です。