
 
目录
- C语言时间函数详解
 - 表格汇总
 - 1. `time`
 - 2. `localtime`
 - 3. `gmtime`
 - 4. `strftime`
 - 5. `clock`
 - 6. `difftime`
 - 函数详解
 - 示例解释
 
- 7. `mktime`
 - 8. `asctime`
 - 9. `ctime`
 - 10. `clock_gettime` 和 `clock_settime`
 - 总结
 - 9. 结束语
 - 相关文章:
 
C语言时间函数详解
在C语言中,时间处理功能由标准库 time.h 提供。使用这些函数时,需要包含 #include <time.h> 头文件。以下是一些常用的时间函数的详细讲解,包括函数原型、参数说明、返回值说明以及示例代码和表格汇总。
表格汇总
| 函数 | 作用 | 示例 | 输出 | 
|---|---|---|---|
time | 获取当前时间 | time(NULL) | 时间戳 | 
localtime | 将时间戳转换为本地时间结构体 | localtime(×tamp) | struct tm 结构体 | 
gmtime | 将时间戳转换为UTC时间结构体 | gmtime(×tamp) | struct tm 结构体 | 
strftime | 格式化时间为字符串 | strftime(buffer, size, format, &tm) | 格式化后的时间字符串 | 
clock | 获取程序运行时间 | clock() | CPU时间 | 
difftime | 计算两个时间点之间的差值 | difftime(end, start) | 时间差(秒) | 
mktime | 将struct tm转换为时间戳 | mktime(&tm) | 时间戳 | 
1. time
 
函数原型:
time_t time(time_t *t);
 
参数说明:
t: 如果不为NULL,则函数将当前时间存储在t指向的变量中。
返回值说明:
- 返回当前的时间戳(从1970年1月1日00:00:00 UTC到现在的秒数)。
 
示例代码:
#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    current_time = time(NULL);
    printf("当前时间戳: %ld\n", (long)current_time); // 输出: 当前时间戳: 1634602475
    return 0;
}
 
表格说明:
| 函数 | 作用 | 示例 | 输出 | 
|---|---|---|---|
time | 获取当前时间 | time(NULL) | 当前时间戳 | 
2. localtime
 
函数原型:
struct tm *localtime(const time_t *timep);
 
参数说明:
timep: 指向time_t类型的时间戳。
返回值说明:
- 返回指向 
struct tm结构体的指针,该结构体包含本地时间的详细信息。 
示例代码:
#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    struct tm *local_time;
    current_time = time(NULL);
    local_time = localtime(¤t_time);
    printf("本地时间: %04d-%02d-%02d %02d:%02d:%02d\n",
           local_time->tm_year + 1900,
           local_time->tm_mon + 1,
           local_time->tm_mday,
           local_time->tm_hour,
           local_time->tm_min,
           local_time->tm_sec); // 输出: 本地时间: 2024-08-15 12:34:56
    return 0;
}
 
表格说明:
| 函数 | 作用 | 示例 | 输出 | 
|---|---|---|---|
localtime | 将时间戳转换为本地时间结构体 | localtime(¤t_time) | 本地时间: 2024-08-15 12:34:56 | 
3. gmtime
 
函数原型:
struct tm *gmtime(const time_t *timep);
 
参数说明:
timep: 指向time_t类型的时间戳。
返回值说明:
- 返回指向 
struct tm结构体的指针,该结构体包含UTC时间的详细信息。 
示例代码:
#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    struct tm *utc_time;
    current_time = time(NULL);
    utc_time = gmtime(¤t_time);
    printf("UTC时间: %04d-%02d-%02d %02d:%02d:%02d\n",
           utc_time->tm_year + 1900,
           utc_time->tm_mon + 1,
           utc_time->tm_mday,
           utc_time->tm_hour,
           utc_time->tm_min,
           utc_time->tm_sec); // 输出: UTC时间: 2024-08-15 04:34:56
    return 0;
}
 
表格说明:
| 函数 | 作用 | 示例 | 输出 | 
|---|---|---|---|
gmtime | 将时间戳转换为UTC时间结构体 | gmtime(¤t_time) | UTC时间: 2024-08-15 04:34:56 | 
4. strftime
 
函数原型:
size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *tm);
 
参数说明:
str: 指向存储格式化时间字符串的缓冲区。maxsize: 缓冲区的最大大小。format: 格式化时间的格式字符串。tm: 指向struct tm结构体的指针。
返回值说明:
- 返回格式化字符串的长度。如果返回值等于0,则表示缓冲区不够大,未能完全写入。
 
示例代码:
#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    struct tm *local_time;
    char buffer[80];
    current_time = time(NULL);
    local_time = localtime(¤t_time);
    strftime(buffer, sizeof(buffer), "当前时间: %Y-%m-%d %H:%M:%S", local_time);
    printf("%s\n", buffer); // 输出: 当前时间: 2024-08-15 12:34:56
    return 0;
}
 
表格说明:
| 函数 | 作用 | 示例 | 输出 | 
|---|---|---|---|
strftime | 格式化时间为字符串 | strftime(buffer, sizeof(buffer), "%Y-%m-%d %H:%M:%S", &local_time) | 当前时间: 2024-08-15 12:34:56 | 
5. clock
 
函数原型:
clock_t clock(void);
 
参数说明:
- 无参数。
 
返回值说明:
- 返回程序从启动到当前时刻所消耗的CPU时间,以时钟计数的形式表示。
 
示例代码:
#include <stdio.h>
#include <time.h>
int main() {
    clock_t start, end;
    double cpu_time_used;
    start = clock();
    // 模拟耗时操作
    for (long i = 0; i < 1000000000; i++);
    end = clock();
    cpu_time_used = ((double) (end - start)) / CLOCKS_PER_SEC;
    printf("程序运行时间: %f 秒\n", cpu_time_used); // 输出: 程序运行时间: 0.123456 秒
    return 0;
}
 
表格说明:
| 函数 | 作用 | 示例 | 输出 | 
|---|---|---|---|
clock | 获取程序运行时间 | clock() | 程序运行时间: 0.123456 秒 | 
6. difftime
 
函数原型:
double difftime(time_t time1, time_t time2);
 
参数说明:
time1: 第二个时间点的时间戳。time2: 第一个时间点的时间戳。
返回值说明:
- 返回 
time1和time2之间的时间差,以秒为单位。结果为time1 - time2的值。 
示例代码:
#include <stdio.h>
#include <time.h>
int main() {
    time_t start, end;
    double difference;
    // 获取当前时间戳作为开始时间
    start = time(NULL);
    
    // 模拟耗时操作
    for (long i = 0; i < 1000000000; i++);
    // 获取当前时间戳作为结束时间
    end = time(NULL);
    // 计算两个时间戳之间的差值
    difference = difftime(end, start);
    printf("时间差: %.f 秒\n", difference); // 输出: 时间差: 2 秒
    return 0;
}
 
表格说明:
| 函数 | 作用 | 示例 | 输出 | 
|---|---|---|---|
difftime | 计算两个时间点之间的时间差(秒) | difftime(end, start) | 时间差: 2 秒 | 
函数详解
difftime 函数用于计算两个时间点之间的差值,并以秒为单位返回。它的参数是两个 time_t 类型的时间戳。time1 和 time2 分别表示结束时间和开始时间。函数返回 time1 - time2 的结果,结果是一个 double 类型的值,表示时间差(秒)。
示例解释
在上面的示例代码中,我们首先获取了当前时间的时间戳 start,然后模拟了一个耗时的操作。之后,再次获取当前时间的时间戳 end。使用 difftime 函数计算 end 和 start 之间的时间差,得到的结果表示操作所花费的时间(以秒为单位),并打印出来。
这种计算在需要测量程序运行时间、执行时间段的任务等情况下非常有用。通过 difftime 函数,可以方便地获取两个时间点之间的时间差,从而分析和优化程序性能。
7. mktime
 
函数原型:
time_t mktime(struct tm *tm);
 
参数说明:
tm: 指向struct tm结构体的指针,该结构体包含要转换为时间戳的本地时间信息。
返回值说明:
- 返回将 
struct tm结构体表示的本地时间转换为time_t类型的时间戳。如果无法转换,返回-1。 
示例代码:
#include <stdio.h>
#include <time.h>
int main() {
    struct tm time_info;
    time_t timestamp;
    // 设置特定的时间
    time_info.tm_year = 2024 - 1900;  // 年份从1900年开始
    time_info.tm_mon = 7;             // 月份从0开始(即8月)
    time_info.tm_mday = 15;           // 日期
    time_info.tm_hour = 12;
    time_info.tm_min = 30;
    time_info.tm_sec = 0;
    time_info.tm_isdst = -1;          // 让系统自动判断夏令时
    timestamp = mktime(&time_info);
    if (timestamp != -1) {
        printf("时间戳: %ld\n", (long)timestamp); // 输出: 时间戳: 1713102600
    } else {
        printf("时间转换失败\n");
    }
    return 0;
}
 
表格说明:
| 函数 | 作用 | 示例 | 输出 | 
|---|---|---|---|
mktime | 将 struct tm 转换为时间戳 | mktime(&time_info) | 时间戳: 1713102600 | 
8. asctime
 
函数原型:
char *asctime(const struct tm *tm);
 
参数说明:
tm: 指向struct tm结构体的指针。
返回值说明:
- 返回一个指向包含时间的字符串的指针,字符串的格式为 
"Day Mon Date HH:MM:SS Year\n"。 
示例代码:
#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    struct tm *local_time;
    char *time_str;
    current_time = time(NULL);
    local_time = localtime(¤t_time);
    time_str = asctime(local_time);
    printf("本地时间: %s", time_str); // 输出: 本地时间: Mon Aug 15 12:34:56 2024\n
    return 0;
}
 
表格说明:
| 函数 | 作用 | 示例 | 输出 | 
|---|---|---|---|
asctime | 将 struct tm 转换为字符串 | asctime(&local_time) | 本地时间: Mon Aug 15 12:34:56 2024\n | 
9. ctime
 
函数原型:
char *ctime(const time_t *timep);
 
参数说明:
timep: 指向time_t类型的时间戳。
返回值说明:
- 返回一个指向包含时间的字符串的指针,字符串的格式为 
"Day Mon Date HH:MM:SS Year\n"。 
示例代码:
#include <stdio.h>
#include <time.h>
int main() {
    time_t current_time;
    char *time_str;
    current_time = time(NULL);
    time_str = ctime(¤t_time);
    printf("当前时间: %s", time_str); // 输出: 当前时间: Mon Aug 15 12:34:56 2024\n
    return 0;
}
 
表格说明:
| 函数 | 作用 | 示例 | 输出 | 
|---|---|---|---|
ctime | 将时间戳转换为字符串 | ctime(¤t_time) | 当前时间: Mon Aug 15 12:34:56 2024\n | 
10. clock_gettime 和 clock_settime
 
函数原型:
int clock_gettime(clockid_t clk_id, struct timespec *tp);
int clock_settime(clockid_t clk_id, const struct timespec *tp);
 
参数说明:
clk_id: 计时器ID,通常是CLOCK_REALTIME或CLOCK_MONOTONIC。tp: 指向struct timespec结构体的指针,struct timespec结构体定义如下:struct timespec { time_t tv_sec; // 秒 long tv_nsec; // 纳秒 };
返回值说明:
- 成功时返回 
0,失败时返回-1,并设置errno以指示错误类型。 
示例代码:
#include <stdio.h>
#include <time.h>
int main() {
    struct timespec ts;
    // 获取当前时间
    if (clock_gettime(CLOCK_REALTIME, &ts) == 0) {
        printf("当前时间: %ld 秒, %ld 纳秒\n", ts.tv_sec, ts.tv_nsec); // 输出: 当前时间: 1634602475 秒, 123456789 纳秒
    } else {
        perror("clock_gettime");
    }
    return 0;
}
 
表格说明:
| 函数 | 作用 | 示例 | 输出 | 
|---|---|---|---|
clock_gettime | 获取指定时钟的时间 | clock_gettime(CLOCK_REALTIME, &ts) | 当前时间: 1634602475 秒, 123456789 纳秒 | 
总结
在C语言中,时间函数提供了丰富的功能来处理时间和日期。time 函数获取当前时间戳,localtime 和 gmtime 函数将时间戳转换为 struct tm 结构体表示的本地时间和UTC时间。strftime 函数格式化时间字符串,clock 函数获取程序的CPU时间,difftime 函数计算两个时间点之间的差值,mktime 函数将 struct tm 结构体转换为时间戳。asctime 和 ctime 函数将时间转换为字符串格式。
了解并正确使用这些时间函数,可以有效地处理时间和日期相关的任务,从而在程序中实现各种时间计算和格式化需求。
9. 结束语
- 本节内容已经全部介绍完毕,希望通过这篇文章,大家对C语言时间函数有了更深入的理解和认识。
 - 感谢各位的阅读和支持,如果觉得这篇文章对你有帮助,请不要吝惜你的点赞和评论,这对我们非常重要。再次感谢大家的关注和支持!点我关注❤️
 
相关文章:
- 指针的神秘探险:从入门到精通的奇幻之旅 !
 










![[Linux]将一个文件复制到多个文件夹下](https://i-blog.csdnimg.cn/direct/21fdf546e35c45c0a3046dbd179ff15f.png#pic_center)







