c&c++ datetime

时间函数之间的关系

struct tm
{
    int tm_sec;    // 代表目前秒数,正常范围0-59,但允许至61秒;
    int tm_min;    // 代表目前分数,范围为0-59。
    int tm_hour;   // 从午夜算起的小时数,范围为0-23。
    int tm_mday;   // 目前月份的日数,范围为1-31。
    int tm_mon;    // 代表目前月份,从一月算起,范围为0-11。
    int tm_year;   // 从1900年算起至今的年数。比如(时间戳1970-01-02 10:23:09,该值为70)。
    int tm_wday;   // 一星期中的日数,从星期日算起,范围为0-6。
    int tm_yday;   // 从1月1日算起至今的天数,范围为:0-365。
    int tm_isdst;  // 日光节约时间的旗标。
};
#include <time.h>
time_t time(time_t * t);
此函数会返回从公元1970年1月1日的UTC时间从0时0分0秒算起到现在所经过的秒数。如果t并非空指针的话,此函数也会将返回值存到t指针所指的内存。如果失败则返回((time_t)-1)。

#include <time.h>
struct tm * gmtime(const time_t * timep);
该函数将参数timep所指的time_t结构中的信息转换成真实世界所使用的日期表示方法,然后将结果由结构tm返回。该返回值代表目前的UTC时间。

#include <time.h>
struct tm * localtime(const time_t * timep);
该函数将参数timep所指的time_t结构中的信息转换成真实世界所使用的日期表示方法,然后将结果由结构tm返回。该返回值代表目前的当地时区的当地时间。

#include <time.h>
time_t mktime(struct tm * timeptr);
该函数将参数timeptr所指的tm结构数据转换成从公元1970年1月1日0时0分0秒算起的至今的UTC时间所经过的秒数。

#include <time.h>
size_t strftime(char *s, size_t max, const char *format, const struct tm *tm);
该函数将参数tm,依照参数format所指定的字符串格式做转换,转换后的字符串复制到参数s所指的字符串数组中,该字符串的最大长度为参数max所控制。

#include <time.h>
char *strptime(const char *s, const char *format, struct tm *tm);
该函数将参数s所指定的按一定格式要求编制的字符串,根据格式化参数format,转换成tm结构的值。如果分析错误,返回NULL。
strftime和strptime的格式参数
参数 含义
%a 星期几的简写
%A 星期几的全称
%A 星期几的全称
%b 月分的简写
%B 月份的全称
%c 标准的日期的时间串
%C 年份的前两位数字,比如1997年表示为:19
%d 十进制表示的每月的第几天,表示法为:01-31
%D 格式为“月/天/年”表示时间。相当于“%m%d%y”格式。例如“19970701”
%e 十进制表示的每月的第几天(不补0),表示法为:1-31。
%F 使用“%Y-%m-%d”格式表示日期。例如“1997-07-01”。
%g 年份的后两位数字,比如1997年表示为:97
%G 完整的公元年份表示,比如1997年表示:1997
%h 同“%b”一样,简写的月份名。
%H 以24小时制表示小时数(00-23)。
%I 以12小时制表示小时数(01-12)。
%j 十进制表示一年中的天数(001-366)。
%k 同“%H”,表示法为:0-23
%l 同“%I”,表示法为:1-12。
%m 十进制表示的月份,表示法:01-12。
%M 十时制表示的分钟数,表示法:00-59。
%n 同“ ”,换行。
%p 本地AM或PM的等价显示。
%P 同“%p”相似,但使用小写的am和pm来表示。
%r 相当于使用“%I:%M:%S %p”格式,例如:“08:31:50 PM”。
%R 相当于使用“%H:%M”格式,例如:“22:31”。
%S 十进制的秒数,表示法:00-59。
%t 水平制表符,同“ ”
%T 24小时时间表示,相当于“%H:%M:%S”格式。
%u 一星期中的星期日期,范围:1-7,星期一从1开始。
%U 一年中的星期数,范围:00-53,一月第一个星期日开始为01。
%V 一年中的星期数,范围:00-53,一月第一个星期一开始为01。
%w 一星期中的星期日期,范围:0-6,星期日从0开始。
%W 一年中的星期数,范围:00-53,一月第一个星期一开始为01。
%x 标准的日期串。比如2017年1月2日,表示成:"01/02/17"。
%X 标准的时间串。比如2017年1月2日10点23分9秒,表示成:“10:23:09”。
%y 不带世纪的十进制年份(值从0到99)
%Y 带世纪部分的十制年份
%z,%Z 时区名称,如果不能得到时区名称则返回空字符。
%% 百分号


关于%U参数:
比如2017年的1月1日是星期日,使用%U得到的值是“01”
比如2016年的1月1日是星期五,使用%U得到的值是“00”

关于%V参数:
比如2017年的1月1日是星期日,使用%V得到的值是“52”
比如2017年的1月1日是星期一,使用%V得到的值是“01”
比如2016年的1月1日是星期五,使用%V得到的值是“53”
更新记录
1.20170720 更新时间函数关系图;
原文地址:https://www.cnblogs.com/motadou/p/cc-datetime.html