1、·函数详解及示例
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;
}
