timespec_get

 

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>
int timespec_get( struct timespec *ts, int base );	(1)	(C11 起)
#define TIME_UTC /* implementation-defined */	(2)	(C11 起)

1) 修改由 ts 指向的 timespec 物件，使其儲存時間基準 base 中的當前日曆時間。

2) 展開為一個適合用作 timespec_get 的 base 引數的值

實現可以提供其他以 TIME_ 開頭的宏常量，以指示額外的時間基準

如果 base 是 TIME_UTC，則

• ts->tv_sec 被設定為自實現定義紀元以來的秒數，截斷為整數值
• ts->tv_nsec 成員被設定為納秒的整數值，四捨五入到系統時鐘的解析度

引數

ts	-	指向 struct timespec 型別物件的指標
base	-	TIME_UTC 或指示時間基準的另一個非零整數值

返回值

如果成功，返回 base 的值，否則返回零。

注意

POSIX 函式 clock_gettime(CLOCK_REALTIME, ts) 也可用於填充一個包含自紀元以來時間的 timespec。

示例

執行此程式碼

#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);
}

可能的輸出

Current time: 02/18/15 14:34:03.048508855 UTC

參考

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

• 7.27.2.5 timespec_get 函式 (p: TBD)

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

• 7.27.2.5 timespec_get 函式 (p: 286)

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

• 7.27.2.5 timespec_get 函式 (p: 390)

參見

timespec (C11)	秒和納秒時間 (struct)
timespec_getres (C23)	根據給定時間基準返回日曆時間的解析度 (function)
time	返回系統當前日曆時間，自紀元起的時間 (function)
C++ 文件 用於 timespec_get