timespec

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

日付と時刻のユーティリティ

関数

時刻操作

difftime

time

clock

timespec_get (C11)

timespec_getres (C23)

書式変換

asctimeasctime_s (C23で非推奨)(C11)

ctimectime_s (C23で非推奨)(C11)

strftime

wcsftime (C95)

gmtimegmtime_rgmtime_s (C23)(C11)

localtimelocaltime_rlocaltime_s (C23)(C11)

mktime

定数

CLOCKS_PER_SEC

型

tm

time_t

clock_t

timespec (C11)

 

ヘッダー <time.h> で定義
struct timespec;		(C11 以降)

秒とナノ秒に分割された時間間隔を保持する構造体。

メンバ変数

メンバ	説明
time_t tv_sec	秒単位（有効な値は ​0​ 以上）
/* 下記参照 */ tv_nsec	ナノ秒単位（有効な値は [​0​, 999999999]）

tv_nsec の型は long です。	(C23まで)
tv_nsec の型は、[​0​, 999999999] の整数値を表現できる、実装定義の符号付き整数型です。	(C23以降)

tv_sec と tv_nsec の宣言順序は未指定です。実装は struct timespec に他のメンバを追加する場合があります。

注記

一部のプラットフォームでは tv_nsec の型は long long ですが、これは C23 以降でのみ準拠しています。

例

このコードを実行

#include <stdint.h>
#include <stdio.h>
#include <time.h>
 
int main(void)
{
    struct timespec ts;
    timespec_get(&ts, TIME_UTC);
    char buff[100];
    strftime(buff, sizeof buff, "%D %T", gmtime(&ts.tv_sec));
    printf("Current time: %s.%09ld UTC\n", buff, ts.tv_nsec);
    printf("Raw timespec.tv_sec: %jd\n", (intmax_t)ts.tv_sec);
    printf("Raw timespec.tv_nsec: %09ld\n", ts.tv_nsec);
}

実行結果の例

Current time: 04/04/24 14:45:17.885909786 UTC
Raw timespec.tv_sec: 1712241917
Raw timespec.tv_nsec: 885909786

参照

• C23標準 (ISO/IEC 9899:2024)

• 7.27.1/3 時間の構成要素 (p: TBD)

• C17標準 (ISO/IEC 9899:2018)

• 7.27.1/3 時間の構成要素 (p: 284)

• C11標準 (ISO/IEC 9899:2011)

• 7.27.1/3 時間の構成要素 (p: 388)

関連項目

timespec_get (C11)	与えられた時間基準に基づいて、カレンダー時間を秒とナノ秒で返す (関数)
tm	カレンダー時間型 (構造体)
timespec の C++ ドキュメント