difftime

 

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>
double difftime( time_t time_end, time_t time_beg );

計算兩個日曆時間（time_t 物件）之間的差值，以秒為單位（time_end - time_beg）。如果 time_end 表示的時間點在 time_beg 之前，則結果為負數。

引數

time_beg, time_end

-

要比較的時間

返回值

兩個時間之間的差值，以秒為單位。

注意

在 POSIX 系統上，time_t 以秒為單位進行度量，difftime 等同於算術減法，但 C 和 C++ 允許 time_t 使用分數單位。

示例

以下程式計算自本月開始以來已經過去的秒數。

執行此程式碼

#include <stdio.h>
#include <time.h>
 
int main(void)
{
    time_t now = time(0);
 
    struct tm beg = *localtime(&now);
 
    // set beg to the beginning of the month
    beg.tm_hour = 0,
    beg.tm_min = 0,
    beg.tm_sec = 0,
    beg.tm_mday = 1;
 
    double seconds = difftime(now, mktime(&beg));
 
    printf("%.f seconds have passed since the beginning of the month.\n", seconds);
 
    return 0;
}

輸出

1937968 seconds have passed since the beginning of the month.

參考

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

• 7.27.2.2 difftime 函式 (p: 285)

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

• 7.27.2.2 difftime 函式 (p: 390)

• C99 標準 (ISO/IEC 9899:1999)

• 7.23.2.2 difftime 函式 (p: 338)

• C89/C90 標準 (ISO/IEC 9899:1990)

• 7.12.2.2 difftime 函式 (p: 171)

另請參閱

C++ 文件 用於 difftime