ctime

日历时间（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
",currTime());
    printf("%s
",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