＜C/C++＞日期和时间的使用（time相关函数大全）

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;
}