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);
 
    // 设 beg 为月初
    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 The difftime function （第 285 页）

• C11 标准（ISO/IEC 9899:2011）：

• 7.27.2.2 The difftime function （第 390 页）

• C99 标准（ISO/IEC 9899:1999）：

• 7.23.2.2 The difftime function （第 339 页）

• C89/C90 标准（ISO/IEC 9899:1990）：

• 4.12.2.2 The difftime function