日历时间（Calendar Time），是从一个标准时间点（epoch）到现在的时间经过的秒数，不包括插入闰秒对时间的调整。开始计时的标准时间点，各种编译器一般使用UTC 1970-01-01 00:00:00。日历时间用数据类型time_t表示。[1]:20time_t类型实际上一般是32位整数类型，因此表示的时间不能晚于UTC 2038-01-18 19:14:07。为此，某些编译器引入了64位甚至更长的整型来保存日历时间，如Visual C++支持__time64_t数据类型，通过_time64()函数获取日历时间，可支持到UTC 3001-01-01 00:00:00的时间。

分解时间(broken-down time)，用结构数据类型tm表示。

tm数据结构

struct tm { 　　int tm_sec; /* 秒 – 取值区间为[0,59] */ 　　int tm_min; /* 分 - 取值区间为[0,59] */ 　　int tm_hour; /* 时 - 取值区间为[0,23] */ 　　int tm_mday; /* 日期 - 取值区间为[1,31] */ 　　int tm_mon; /* 月份 - 取值区间为[0,11] (0代表一月)*/ 　　int tm_year; /* 年份 - 其值等于实际年份减去1900 */ 　　int tm_wday; /* 星期 – 取值区间为[0,6]，其中0代表星期天，1代表星期一，以此类推 */ 　　int tm_yday; /* 天数 – 取值区间为[0,365]，其中0代表1月1日，1代表1月2日 */ 　　int tm_isdst; /* 夏令时标识符,实行时tm_isdst为正,不实行时为0；不了解情况时为负。*/ };

函数

获取当前时间

time_t time(time_t* timer) 得到从标准计时点（一般是1970年1月1日午夜）到当前时间的秒数。如果 seconds 不为空，则返回值也存储在变量 seconds 中。

clock_t clock(void) 得到从进程启动到此次函数调用的累计的时钟滴答数。

日期转换

struct tm* gmtime(const time_t* timer) 从日历时间time_t到分解时间tm（世界协调时UTC）的转换。

struct tm* localtime(const time_t* timer) 从日历时间time_t到分解时间tm的转换，即结果数据已经调整到本地时区与夏令时。

time_t mktime(struct tm* ptm) 从基于本地时区(与夏令时)的分解时间tm到日历时间time_t的转换。

time_t timegm(struct tm* brokentime) 从分解时间tm（被视作UTC时间，不考虑本地时区设置）到日历时间time_t的转换。该函数较少被使用。

struct tm* gmtime_r(const time_t* timer, struct tm* result) 该函数是gmtime函数的线程安全版本。

日期格式化

char *asctime(const struct tm* tmptr) 把分解时间tm输出到字符串，结果的格式为"Www Mmm dd hh:mm:ss yyyy"，即“周几 月份数 日数 小时数:分钟数:秒钟数 年份数”。函数返回的字符串为静态分配，长度不大于26，与ctime函数共享。函数的每次调用将覆盖该字符串内容。

char* ctime(const time_t* timer) 把日历时间time_t timer输出到字符串，输出格式与asctime函数一样.

size_t strftime(char* s, size_t n, const char* format, const struct tm* tptr) 把分解时间tm转换为自定义格式的字符串，类似于常见的字符串格式输出函数sprintf。format如下：

%a 星期几的简写 %A 星期几的全称 %b 月份的简写 %B 月份的全称 %c 标准的日期的时间串 %C 年份的前两位数字 %d 十进制表示的每月的第几天 %D 月/天/年 %e 在两字符域中，十进制表示的每月的第几天 %F 年-月-日 %g 年份的后两位数字，使用基于周的年 %G 年份，使用基于周的年 %h 简写的月份名 %H 24小时制的小时 %I 12小时制的小时 %j 十进制表示的每年的第几天 %m 十进制表示的月份 %M 十时制表示的分钟数 %n 新行符 %p 本地的AM或PM的等价显示 %r 12小时的时间 %R 显示小时和分钟：hh:mm %S 十进制的秒数 %t 水平制表符 %T 显示时分秒：hh:mm:ss %u 每周的第几天，星期一为第一天 （值从1到7，星期一为1） %U 第年的第几周，把星期日作为第一天（值从0到53） %V 每年的第几周，使用基于周的年 %w 十进制表示的星期几（值从0到6，星期天为0） %W 每年的第几周，把星期一做为第一天（值从0到53） %x 标准的日期串 %X 标准的时间串 %y 不带世纪的十进制年份（值从0到99） %Y 带世纪部分的十制年份 %z，%Z 时区名称，如果不能得到时区名称则返回空字符。 %% 百分号

char * strptime(const char* buf, const char* format, struct tm* tptr) strftime的逆操作，把字符串按照自定义的格式转换为分解时间tm。

日期差

double difftime(time_t timer2, time_t timer1) 比较两个日历时间之差。

例程

输出当前时间

#include <stdio.h> #include <time.h> char *currTime(const char *format) { static char buf[1000]; time_t t; size_t s; struct tm *tm; t = time(NULL); tm = localtime(&t); if (tm == NULL) return NULL; s = strftime(buf, 1000, (format != NULL) ? format : "%c", tm); return (s == 0) ? NULL : buf; } char *currTime() { static char buf[1000]; time_t t; size_t s; struct tm *tm; t = time(NULL); tm = localtime(&t); if (tm == NULL) return NULL; s = strftime(buf, 1000, "%c", tm); return (s == 0) ? NULL : buf; } int main(void) { printf("%s\n",currTime()); printf("%s\n",currTime("%T")); return 0; } Wed Feb 12 16:37:20 2020 16:37:20

获取目标时间到今天的天数

#include <iostream> #include <ctime> int main() { time_t nowTimeSec; time(&nowTimeSec); struct std::tm originTime = { 0,0,0,1,0,76 };//1976.01.01 std::time_t originTimeSec = std::mktime(&originTime); int difference = std::difftime(nowTimeSec, originTimeSec) / (60 * 60 * 24); std::cout << "MapAge = " << difference << " days" << std::endl; return 0; } MapAge = 15944 days

获取任意两天的天数差

#include <iostream> #include <ctime> int main() { struct std::tm a = {0,0,0,24,5,104}; /* June 24, 2004 */ struct std::tm b = {0,0,0,5,6,104}; /* July 5, 2004 */ std::time_t x = std::mktime(&a); std::time_t y = std::mktime(&b); if ( x != (std::time_t)(-1) && y != (std::time_t)(-1) ) { double difference = std::difftime(y, x) / (60 * 60 * 24); std::cout << "difference = " << difference << " days" << std::endl; } return 0; } difference = 11 days

参考链接： https://cloud.tencent.com/developer/ask/49142 https://wikipedia.sogou.se/wiki/Time.h