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\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

posted @ 2020-05-12 07:18  多弗朗强哥  阅读(210)  评论(0编辑  收藏  举报