名称

gettimeofday, settimeofday − 日付および時刻を取り出す／セットする

形式

#include <sys/time.h>

gettimeofday(tp, tzp)
struct timeval ∗tp;
struct timezone ∗tzp;

settimeofday(tp, tzp)
struct timeval ∗tp;
struct timezone ∗tzp;

解説

システムの表記法による現在のグリニッジ標準時および現在の現地標準時間帯が、 gettimeofday コールで得られ、 settimeofday コールでセットされます。 時間は、 1970年1月1日零時からの秒およびミリ秒で表されます。 システムクロックの分解能はハードウェアに依存し、 時間は連続的に、 または分解能単位で更新されます。 tp がゼロである場合には、 現在のグリニッジ標準時の情報は返されません(またはセットされません)。 tzp がゼロである場合には、 現地標準時間帯の情報は返されません(またはセットされません)。

tp および tzp によって指し示される構造体は、 <sys/time.h> 内で次のように定義されています。

struct timeval {
longtv_sec;/∗ seconds since Jan. 1, 1970 ∗/
longtv_usec;/∗ and microseconds ∗/
};
struct timezone {
inttz_minuteswest;/∗ of Greenwich ∗/
inttz_dsttime;/∗ type of dst correction to apply ∗/
};

timezone 構造体は、 (グリニッジから西へ向かって分単位で計算された)現地標準時間帯を 示し、 フラグは、 ゼロでなければ、 1年のうちの適切な部分にだけ夏時間を 適用することを 示します。

スーパーユーザだけが時刻または現地標準時間帯を セットすることができます。

リターン値

リターン値 0 はコールが成功したことを 示します。 リターン値 −1 はエラーが発生したことを 示し、 その場合、 エラーコードがグローバル変数 errno に入れられます。

エラー

次のエラーコードが errno にセットされることがあります。

[EFAULT] 引数のアドレスが無効なメモリを 指している。

[EPERM] スーパーユーザ以外のユーザが時間を セットしようとした。

注意事項

NEWS-OS 4.0以前で tp をゼロにするとエラーになったり、不定の時間がシステムに 設定されたりしました。

関連事項

date(1), adjtime(2), ctime(3), timed(8)

NEWS-OSRelease 4.1C