头文件:#include
函数定义: char *strptime(const char *s, const char *format, struct tm *tm);
函数作用:将以字符串形式表示的时间转为 tm 结构体表示的时间。
strptime函数功能与 strftime 函数正好相反。
函数返回值:
strptime 函数从左到右按字符进行匹配,一旦匹配格式不正确或者匹配错误就直接返回匹配错误的字符地址。
如果输入的字符串多余需要匹配的格式,返回正确匹配到的字符地址的下一个字符,也就是多出来的字符的首地址。
如果输入的字符串完全匹配正确,则返回值指向字符串的末尾,也就是'\0'的位置。如果匹配过程出错,返回NULL。
struct tm 结构体定义:
struct tm {
int tm_sec; /* Seconds (0-60) */
int tm_min; /* Minutes (0-59) */
int tm_hour; /* Hours (0-23) */
int tm_mday; /* Day of the month (1-31) */
int tm_mon; /* Month (0-11) */
int tm_year; /* Year - 1900 */
int tm_wday; /* Day of the week (0-6, Sunday = 0) */
int tm_yday; /* Day in the year (0-365, 1 Jan = 0) */
int tm_isdst; /* Daylight saving time */
};
format 可以表示的形式有:
%% 表示百分号(%)
%a or %A 表示星期几的简写(Sun, Mon, ..., Sat)或者全写(Sunday, Monday, ..., Saturday)
%b or %B or %h 月份采用缩写字符表示(Jan, Feb,..., Dec)或者全写(January, February, ...,December)
%c 采用本地合适日期和时间表示(Tue Aug 16 21:30:00 1988)
%C 两位数表示的世纪(0–99),如21表示21世纪,与%Y配合使用。
%d or %e 一个月的第几天(0-31)
%D 相当于 %m/%d/%y,这是美式表示方式。欧洲一般用%d/%m/%y表示,ISO 8601 标准是%Y-%m-%d
%H 24小时制的小时表示(0–23).
%I 12小时制的小时表示(1–12).
%j 一年的第几天 (1–366).
%m 月的表示方式 (1–12).
%M 分钟 (0–59).
%n 空白
%p 本地时间是上午还是下午(AM,PM)
%r 12小时制,相当于%I:%M:%S %p
%R 相当于%H:%M.
%S 表示秒(0–60)
%t 空格
%T 相当于 %H:%M:%S.
%U 表示以星期天作为第一天的第几周 (0–53),以一月的第一个星期天作为一年中第一周的第一天
%w 星期几采用数字表示(0-6),0表示星期日,6表示星期六。
%W 表示以周一作为第一天的第几周(0–53),以一月的第一个星期一作为一年中第一周的第一天
%x 当地格式的日期
%X 当地格式的时间
%y 两位数表示的年(00,99),如果没有指明世纪,69–99表示1969–1999,00–68表示2000–2068
%Y 包含世纪的年,四位数表示,比如1991
备注:strptime 函数只是对 tm 参数赋值,不会对它初始化,所以函数调用之前,最好先初始化一下。
#include
#include
#include
#include
void main(void)
{
struct tm tm;
memset(&tm, 0, sizeof(struct tm));
strptime("2020-06-24 16:31:01", "%Y-%m-%d %H:%M:%S", &tm);
//打印Sun Jun 24 16:31:01 2020
printf("\ntime: %s\n", asctime(&tm));
memset(&tm, 0, sizeof(struct tm));
strptime("24 Jun 2018 18:31:01", "%d %b %Y %H:%M:%S", &tm);
//打印Sun Jun 24 18:31:01 2018
printf("\ntime: %s\n", asctime(&tm));
char time_buffer[26];
struct tm *tm_info;
struct timeval tv;
gettimeofday(&tv, NULL);
tm_info = localtime(&tv.tv_sec);
strftime(time_buffer, 26, "%Y:%m:%d %H:%M:%S", tm_info);
printf("time is [%s]\n", time_buffer);
}
运行效果
strftime()函数原型:
size_t strftime(char *strDest,size_t maxsize,const char *format,const struct tm *timeptr);
strftime()函数:识别以百分号(%)开始的格式命令集合。
格式命令,是区分大小写的:
%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 每周的第几天,星期一为第一天 (值从0到6,星期一为0)
%U 第年的第几周,把星期日做为第一天(值从0到53)
%V 每年的第几周,使用基于周的年
%w 十进制表示的星期几(值从0到6,星期天为0)
%W 每年的第几周,把星期一做为第一天(值从0到53)
%x 标准的日期串
%X 标准的时间串
%y 不带世纪的十进制年份(值从0到99)
%Y 带世纪部分的十进制年份
%z,%Z 时区名称,如果不能得到时区名称则返回空字符。
%% 百分号