C言語で現在時刻を取得する

C言語における timespec_get 関数の詳細解説

int timespec_get(struct timespec *ts, int base);

引数

• ts: 現在のカレンダー時間を格納する struct timespec 型のポインター
• base: 使用するタイムベース。以下のいずれかの値を指定できます。
  • TIME_UTC: Coordinated Universal Time (UTC)
  • TIME_LOCAL: システムのローカルタイム

戻り値

• 成功した場合は base の値を返します。
• 失敗した場合は -1 を返し、errno にエラーコードが設定されます。

動作

timespec_get 関数は、base で指定されたタイムベースに基づいて、現在のカレンダー時間を ts 構造体に格納します。ts 構造体は、以下の 2 つのメンバーを持っています。

• tv_sec: 現在の時刻の秒数

例

以下のコードは、timespec_get 関数を使用して、現在の UTC 時刻を取得し、標準出力に出力する例です。

#include <stdio.h>
#include <time.h>

int main() {
  struct timespec ts;

  // UTC 時刻を取得
  timespec_get(&ts, TIME_UTC);

  // 現在の時刻を出力
  printf("Current UTC time: %ld.%09ld\n", ts.tv_sec, ts.tv_nsec);

  return 0;
}

注意事項

• timespec_get 関数は、POSIX.1-2001 規格で定義されています。
• この関数は、すべてのプラットフォームでサポートされているわけではありません。
• timespec_get 関数は、クロック精度の影響を受けます。クロック精度は、システムによって異なります。

補足

• timespec_get 関数は、clock_gettime 関数と似ています。clock_gettime 関数は、より多くの機能を提供しますが、timespec_get 関数よりも複雑です。
• 現在の時刻を取得するその他の方法として、gettimeofday 関数があります。gettimeofday 関数は、timespec_get 関数よりも古い関数ですが、timespec_get 関数よりも精度が低い場合があります。

C言語における timespec_get 関数のサンプルコード

現在の UTC 時刻を取得する

#include <stdio.h>
#include <time.h>

int main() {
  struct timespec ts;

  // UTC 時刻を取得
  timespec_get(&ts, TIME_UTC);

  // 現在の時刻を出力
  printf("Current UTC time: %ld.%09ld\n", ts.tv_sec, ts.tv_nsec);

  return 0;
}

現在のローカル時刻を取得する

#include <stdio.h>
#include <time.h>

int main() {
  struct timespec ts;

  // ローカル時刻を取得
  timespec_get(&ts, TIME_LOCAL);

  // 現在の時刻を出力
  printf("Current local time: %ld.%09ld\n", ts.tv_sec, ts.tv_nsec);

  return 0;
}

2 つの時刻の差を計算する

#include <stdio.h>
#include <time.h>

int main() {
  struct timespec ts1, ts2;
  long seconds, nanoseconds;

  // 2 つの時刻を取得
  timespec_get(&ts1, TIME_UTC);
  timespec_get(&ts2, TIME_UTC);

  // 2 つの時刻の差を計算
  seconds = ts2.tv_sec - ts1.tv_sec;
  nanoseconds = ts2.tv_nsec - ts1.tv_nsec;

  // 時間差を出力
  printf("Time difference: %ld.%09ld seconds\n", seconds, nanoseconds);

  return 0;
}

特定の時刻を待つ

#include <stdio.h>
#include <time.h>

int main() {
  struct timespec ts;

  // 特定の時刻を設定
  ts.tv_sec = 1647424000; // 2024-03-14 12:00:00 UTC
  ts.tv_nsec = 0;

  // 特定の時刻まで待つ
  while (timespec_get(&ts, TIME_UTC) < 0) {
    // エラー処理
  }

  // 特定の時刻に達したことを出力
  printf("Target time reached!\n");

  return 0;
}

C言語で現在時刻を取得する他の方法

time 関数

time 関数は、現在の時刻を 秒 単位で取得します。

#include <time.h>

time_t t;

// 現在の時刻を取得
t = time(NULL);

// 現在の時刻を出力
printf("Current time: %ld\n", t);

gettimeofday 関数

gettimeofday 関数は、現在の時刻を 秒 と マイクロ秒 単位で取得します。

#include <sys/time.h>

struct timeval tv;

// 現在の時刻を取得
gettimeofday(&tv, NULL);

// 現在の時刻を出力
printf("Current time: %ld.%06ld\n", tv.tv_sec, tv.tv_usec);

clock_gettime 関数

clock_gettime 関数は、現在の時刻を 秒 と ナノ秒 単位で取得します。

#include <time.h>

struct timespec ts;

// 現在の時刻を取得
clock_gettime(CLOCK_REALTIME, &ts);

// 現在の時刻を出力
printf("Current time: %ld.%09ld\n", ts.tv_sec, ts.tv_nsec);

strftime 関数

strftime 関数は、現在の時刻を 文字列 に変換します。

#include <time.h>

char buf[100];
time_t t;

// 現在の時刻を取得
t = time(NULL);

// 現在の時刻を文字列に変換
strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", localtime(&t));

// 現在の時刻を出力
printf("Current time: %s\n", buf);

これらの方法はそれぞれ、精度や機能が異なります。