一、·与时间相关的变量类型
与时间相关的类型有四个,分别是:time_t、clock_t、size_t、tm。
tm是一个结构体类型,系统定义如下:
/* tm结构体 */ struct tm { int tm_sec; // 秒:0-59(允许至61) int tm_min; // 分:0-59 int tm_hour; // 时:0-23 int tm_mday; // 日:1-31 int tm_mon; // 月:0-11 int tm_year; // 年:自1900年起的年数 int tm_wday; // 星期:0-6(从星期日算起) int tm_yday; // 一年中的第几天:0-365(从1月1日算起) int tm_isdst; // 夏令时 };
二、·关于日期、时间相关的函数表格总览
三、·函数详解及示例
1- time_t time(time_t *time);
1)功能:获取或设置系统时间。
2)参数:若给定参数,则将当前时间保存到该参数中;若不给定参数,参数填NULL。
3)返回值:返回当前日历时间。自1970-01-01到目前的秒数。
4)说明:time_t可以理解为long类型。
例:
结果:/* time() */ #include <stdio.h> #include <time.h> int main(void) { time_t t = time(NULL); // 等价于:time_t t; time(&t); printf("1970--now的秒数:%ld\n", t); return 0; }
2- char *ctime(const time_t *time);
1)功能:将日期和时间转换为字符串。
2)参数:要转换的日期和时间。
3)返回值:表示当地时间的字符串。
4)说明:参数一般使用time()函数获取的时间。
例:
结果:/* ctime() */ #include <stdio.h> #include <time.h> int main(void) { time_t t; time(&t); printf("Current time:%s", ctime(&t)); return 0; }
3- struct tm *localtime(const time_t *timer);
1)功能:获取结构体格式的系统时间。
2)参数:timer为要转换的时间。3)返回值:指向结构体tm的指针,该结构体信息被timer填充。
4)说明:返回值需要用asctime()函数来转换才能输出。
例:
结果:/* localtime() */ #include <stdio.h> #include <time.h> int main(void) { time_t t; time(&t); struct tm *time_info = localtime(&t); printf("Current-Local time:%s", asctime(time_info)); return 0; }
4- char *asctime(const struct tm *time);
1)功能:将给定的日期和时间转换为ASCII码。
2)参数:要转换的tm结构体类型的时间格式。
3)返回值:指向一个字符串的指针,该字符串包含tm结构体信息。
4)说明:
例:
结果:/* asctime() */ #include <stdio.h> #include <time.h> int main(void) { struct tm t; // 设置时间 t.tm_sec = 10; // 秒 t.tm_min = 18; // 分 t.tm_hour = 7; // 时 t.tm_mday = 16; // 日 t.tm_mon = 6; // 月 t.tm_year = 117; // 年(与1900年相差值) t.tm_wday = 5; // 星期(以周日算起) printf("The time which i set:%s", asctime(&t)); return 0; }
5- clock_t clock(void);
1)功能:计算程序运行时间。
2)参数:无。
3)返回值:该程序执行起,处理器时钟所使用的时间。失败返回-1。
4)说明:clock_t可以理解为long类型。若要获取CPU所使用的秒数,需要将结果除以CLOCKS_PER_SEC。
例:
/* gmtime() */ #include <stdio.h> #include <time.h> int main(void) { clock_t t1, t2; t1 = clock(); //for循环开始前 printf("start:%ld\n", t1); for (int i=0; i<10000000; i++){} t2 = clock(); //for循环结束 printf("end:%ld\n", t2); double t = (double)(t2-t1)/CLOCKS_PER_SEC; printf("for循环CPU所经过的秒数:%lf\n", t); return 0; }
结果:
6- struct tm *gmtime(const time_t *time);
1)功能:将给点的日期和时间转换为格林尼治标准时间(GMT)。
2)参数:要转换的时间。
3)返回值:格林尼治标准时间格式的时间。
4)说明:
例:
结果:/* gmtime() */ #include <stdio.h> #include <time.h> int main(void) { time_t t; struct tm *time_info; time(&t); time_info = gmtime(&t); printf("GMT时间:\n"); printf("时:%02d\n", time_info->tm_hour); printf("分:%02d\n", time_info->tm_min); printf("秒:%02d\n", time_info->tm_sec); return 0; }
7- time_t mktime(struct tm *timeptr);
1)功能:将参数timeptr所指的tm结构数据转换成从公元1970年1月1日0时0分0 秒算起至今的UTC时间所经过的秒数。
2)参数:tm结构体类型。
3)返回值:秒数。
4)说明:与localtime功能相反。
例:
结果:/* mktime() */ #include <stdio.h> #include <time.h> int main() { time_t t; time(&t); printf("time函数获取的秒数: %ld\n", t); // 转换过程 struct tm *time_info = localtime(&t); t = mktime(time_info); printf("time->localtime->mktime转换后的秒数:%ld\n", t); return 0; }
8- double difftime(time_t time2, time_t time1);
1)功能:计算两个时刻之间的时间差。2)参数:两个time_t 类型的时间值。3)返回值:时间差值。4)说明:例:结果:/* difftime() */ #include <stdio.h> #include <time.h> #include <unistd.h> // sleep() int main() { time_t t1 = time(NULL); // 等价于time_t t1; time(&t1); sleep(1); // 休眠/延时1秒 time_t t2 = time(NULL); double result = difftime(t2, t1); printf("差值:%.2lf\n", result); return 0; }
9- size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr);
1)功能:按格式format格式化结构体类型的时间。
2)参数:①str:指向目标数组的指针,用来复制产生的字符串。②maxsize:复制到str的最大字节数。③format:格式。④timeptr:指向tm结构体的指针。
3)返回值:若产生的字符串小于size个字符,返回复制到str中国的字符总数,否则返回0。
4)说明:format格式:
例:
/* strftime() */ #include <stdio.h> #include <time.h> int main(void) { time_t t = time(NULL); struct tm *time_info = localtime(&t); char buf[60] = {}; strftime(buf, 60, "%x %I:%M%p", time_info); printf("格式化后的时间:%s\n", buf); return 0; }
结果:
相关资料:
C语言函数大全(PDF版):点击下载C函数大全
C/C++函数大全(.chm文件):点击下载C/C++函数大全
相关博客:c语言关于时间的头文件封装