【C语言】time.h——主要函数介绍（附有几个小项目）-编程知识

time.h是C标准函数库中获取时间与日期、对时间与日期数据操作及格式化的头文件。

返回值类型

size_t：适合保存sizeof的结果，类型为unsigned int（%u）
clock_t：适合存储处理器时间的类型，一般为unsigned long（%lu）
time_t：适合储存日历时间类型，一般情况下是long。（%ld）
struct tm：保存时间和日期的结构

// 原文注释更容易理解变量的命名
struct tm {int tm_sec;         /* seconds,  range 0 to 59          */int tm_min;         /* minutes, range 0 to 59           */int tm_hour;        /* hours, range 0 to 23             */int tm_mday;        /* day of the month, range 1 to 31  */int tm_mon;         /* month, range 0 to 11             */  // +1int tm_year;        /* The number of years since 1900   */  // +1900int tm_wday;        /* day of the week, range 0 to 6    */  // +1int tm_yday;        /* day in the year, range 0 to 365  */  // +1int tm_isdst;       /* daylight saving time             */
};

宏定义

NULL：空指针
CLOCKS_PER_SEC：其值为1000，表示一秒CPU运行的时钟周期数为1000个，相当于1ms一个时钟周期，因此一般说操作系统的单位是毫秒。

time

功能：返回当前日历时间值，这个值是将时间按照一定逻辑计算得来的

年数 = 天数 * 小时 * 分钟 * 秒（年数 = 365 * 24 * 60 * 60）
得到的日历时间值除于年数，得到结果为自1970年1月1日后经历得年数

函数原型：time_t time(time_t *timer)

返回值：返回自纪元（00：00：00 UTC，1970 年 1 月 1 日）以来的时间，以秒为单位。如果timer不为 NULL，则返回值也存储在变量 timer 中。time_t类型，一般情况下是长整型。（%ld）

参数：为指针类型（一般传入NULL），秒值将存储在指针中。

time_t now = time(NULL); // 等价为time(&now);

注意：

注意区分struct tm中的1900年

返回当前日历时间值
```
#include <stdio.h>
#include <time.h>int main () {time_t now = time(NULL);printf("The final resultl is %ld\n", now);return(0);
}
```
得到的结果为：The final resultl is 1704711506

1704711506 / 365 / 24 / 60 / 60 结果约等于54，加上1970后即为2024

clock

功能：记录程序开始以来使用的时钟周期数，可以记录某段程序执行耗时

函数原型：clock_t clock(void)

返回值：返回程序开始以来使用的时钟周期数，失败则返回-1。clock_t类型（%ld）

计算一段代码所需要的时间

#include <time.h>
#include <stdio.h>int main () {clock_t start_t, end_t;double total_t;int i;start_t = clock();printf("Going to scan a loop, start_t = %ld\n", start_t);for(i=0; i< 50000000; i++);end_t = clock();printf("End of the big loop, end_t = %ld\n", end_t);total_t = (double)(end_t - start_t) / CLOCKS_PER_SEC;  // 得到的结果是以 秒 为单位的printf("Total time taken by CPU: %f\n", total_t  );printf("Exiting of the program...\n");return(0);
}

difftime

功能：返回 time1 和 time2 之间的秒差，即 （time1 - time2）。 这两个时间以日历时间为单位指定，表示自纪元（1970 年 1 月 1 日 00：00：00，协调世界时（UTC））以来经过的时间。

函数原型：double difftime(time_t time1, time_t time2)

参数：

time1 − 这是结束时间time_t对象。
time2 − 这是开始时间time_t对象

返回值： time1 和 time2 之间的秒差作为双精度值返回

计算一段代码所需要的时间

#include <stdio.h>
#include <time.h>int main () {time_t start_t, end_t;double diff_t;printf("Starting of the program...\n");time(&start_t);printf("Sleeping for 5 seconds...\n");sleep(5);time(&end_t);diff_t = difftime(end_t, start_t);printf("Execution time = %f\n", diff_t); // 结果就是以 秒 为单位的printf("Exiting of the program...\n");return(0);
}

my_difftime

double my_difftime(time_t time1, time_t time2){return (double)(time1 - time2);
}

localtime

功能：C 库函数 struct tm localtime（const time_t timer） 使用计时器**指向的时间，用表示相应本地时间的值填充 tm 结构。timer 的值被分解为结构 tm，并以当地时区表示。

函数原型：struct tm *localtime(const time_t *timer)

参数：timer是指向表示日历时间的time_t值的指针，即传入time_t类型的地址。

返回值：返回指向填充了时间信息的 tm 结构的指针，失败则返回NULL。

获取当前日期（当前的和多少天之后的，多少天之前的）

#include <stdio.h>
#include <time.h>void GetTime(){time_t now = time(NULL);  // 获取当前时间状态
//		now += 10 * 24 * 60 * 60; // 获取十天后的时间状态（天 * 时 * 分 * 秒）
//		now -= 10 * 24 * 60 * 60; // 获取十天前的时间状态（天 * 时 * 分 * 秒）struct tm *info = localtime(&now);  int year = info->tm_year + 1900;int month = info->tm_mon + 1;int day = info->tm_mday;int hour = info->tm_hour;int minute = info->tm_min;int second = info->tm_sec;printf("Current time: %d-%02d-%02d %02d:%02d:%02d\n", year, month, day, hour, minute, second);
}int main(){GetTime();return 0;
}

mktime

功能：根据本地时区将 timeptr 指向的结构转换为time_t值。

函数原型：time_t mktime(struct tm *timeptr)

参数：timeprt 是指向结构体tm的指针，即传入struct tm类型的地址。（tm在上面有介绍）

返回值：此函数返回与作为参数传递的日历时间相对应的time_t值。出错时，返回 -1 。

将日期转为时间状态值

#include <stdio.h>
#include <time.h>
#include <math.h> // for abs// 将日期转为time_t
// 利用这个函数，可以计算两个日期之间相隔多少天
time_t tm_convert(int year, int month, int day,int hour, int minute, int second)
{struct tm time_convert;time_convert.tm_year = year - 1900;time_convert.tm_mon = month - 1;time_convert.tm_mday = day;time_convert.tm_hour = hour;time_convert.tm_min = minute;time_convert.tm_sec = second;return mktime(&time_convert);
}void DiffDay()
{time_t start = tm_convert(2023, 12, 15, 0, 0, 0);time_t end = tm_convert(2002, 5, 19, 0, 0, 0);double diff = difftime(start, end);int day = (int)(diff / (24 * 60 * 60)); // 每天所有的秒数printf("相隔%d天.\n", abs(day));
}int main()
{DiffDay();return 0;
}

ctime

功能：返回一个基于参数 timer 的、带有日期信息的字符串，其中包含人类可读格式的日期和时间信息，表示 localtime。

函数原型：char *ctime(const time_t *timer)

返回值：返回一个字符串指针，失败则通常返回NULL。返回的字符串采用以下格式：Www Mmm dd hh：mm：ss yyyy，其中 Www 是工作日，Mmm 是以字母表示的月份，dd 是月份的日期**，hh：mm：ss** 是时间，yyyy 是年份。

参数：指向包含日历时间的time_t对象的指针。

获取当前日期

#include <stdio.h>
#include <time.h>int main () {time_t now = time(NULL);printf("Current time = %s", ctime(&now));return(0);
}

结果
Current time = Tue Jan 09 00:00:17 2024

asctime

功能：返回一个字符串指针。其中包含人类可读格式的日期和时间信息，表示localtime

函数原型：char *asctime(const struct tm *timeptr)

参数：是指向struct tm的一个指针

返回值：此函数返回一个 C 字符串，失败则通常返回NULL。返回的字符串格式为：www Mmm dd hh：mm：ss yyyy，其中 Www 是工作日，Mmm 是字母中的月份，dd 是月份的日期，hh：mm：ss 是时间，yyyy 是年份。

小项目

制作简易时钟

/*制作的一个能显示时间的简易时钟
*/#include <stdio.h>
#include <stdlib.h>
#include <time.h>
#include <windows.h>// 带颜色的打印函数
void print_with_color(char *str, int color)
{HANDLE hConsole = GetStdHandle(STD_OUTPUT_HANDLE);SetConsoleTextAttribute(hConsole, color);printf("%s", str);SetConsoleTextAttribute(hConsole, FOREGROUND_RED | FOREGROUND_GREEN | FOREGROUND_BLUE);
}int main(){while(1){/* 这两个放在外面的话，就不能一直获取当前时间了 */time_t t = time(NULL);struct tm *now = localtime(&t);char str_t[100]; sprintf(str_t, "------------------------\n");print_with_color(str_t, FOREGROUND_BLUE | FOREGROUND_INTENSITY);sprintf(str_t, "| %d/%02d/%02d  %02d:%02d:%02d |\n", now->tm_year + 1900, now->tm_mon + 1, now->tm_mday, now->tm_hour, now->tm_min, now->tm_sec);print_with_color(str_t, FOREGROUND_GREEN | FOREGROUND_INTENSITY);sprintf(str_t, "------------------------\n");print_with_color(str_t, FOREGROUND_BLUE | FOREGROUND_INTENSITY);Sleep(1000);system("cls");}return 0;
}/*1. print_with_color() 函数：用于将字符串打印到控制台并设置颜色。
2. time() 函数：获取当前的时间戳。
3. localtime() 函数：将时间戳转换为本地时间。
4. sprintf() 函数：根据格式化字符串生成一个字符串。
5. FOREGROUND_BLUE、FOREGROUND_GREEN、FOREGROUND_RED、FOREGROUND_INTENSITY 常量：设置文本颜色。
6. Sleep() 函数：暂停一段时间，单位是毫秒。
7. system("cls")：清空控制台。在主函数中，程序使用了一个死循环，不断获取当前时间并更新时钟。
首先，程序使用 time() 函数获取当前时间戳，并使用 localtime() 
函数将其转换为本地时间。然后，程序使用 sprintf() 函数将时钟字符
串格式化，并使用 print_with_color() 函数将其打印到控制台。接着，
程序使用 Sleep() 函数暂停一秒钟，以便下一次更新时钟。最后，程序
使用 system("cls") 函数清空控制台，以便下一次绘制时钟。*/

结果

制作简易日历

#include <stdio.h>
#include <time.h>int main() {time_t t = time(NULL);struct tm *tm = localtime(&t);int year = tm->tm_year + 1900;int month = tm->tm_mon + 1;int day = tm->tm_mday;printf("当前日期：%d年%d月%d日\n", year, month, day);struct tm firstDay;firstDay.tm_year = year - 1900;firstDay.tm_mon = month - 1;firstDay.tm_mday = 1;mktime(&firstDay);int weekday = firstDay.tm_wday;printf("日 一 二 三 四 五 六\n");for (int i = 0; i < weekday; i++) {printf("   ");}int daysInMonth;switch (month) {case 2:if ((year % 4 == 0 && year % 100 != 0) || (year % 400 == 0))daysInMonth = 29;elsedaysInMonth = 28;break;case 4:case 6:case 9:case 11:daysInMonth = 30;break;default:daysInMonth = 31;}for (int d = 1; d <= daysInMonth; d++) {if (d == day) {printf("\033[1;31m%2d\033[0m ", d); // 使用红色高亮显示今天的日期} else {printf("%2d ", d);}if ((weekday + d) % 7 == 0)printf("\n");}return 0;
}

结果

输入日期，计算当前日期是这一年中的第几天（time.h）
（之前发布的一个博客不是用time.h来编写的，这次使用time.h做一个补充）

#include <stdio.h>
#include <time.h>int main() {// 初始化int year, month, day;time_t now = time(NULL);struct tm *timeinfo = localtime(&now);// 获取用户输入日期printf("请输入日期（格式：YYYY-MM-DD）：");scanf("%d-%d-%d", &year, &month, &day);// 更新timeinfo结构体的年月日信息timeinfo->tm_year = year - 1900;timeinfo->tm_mon = month - 1;timeinfo->tm_mday = day;// 计算并输出这一年中的第几天int day_of_year = timeinfo->tm_yday + 1;printf("输入日期在这一年中是第 %d 天\n", day_of_year);return 0;
}