头文件:#include
函数定义: char *strptime(const char *s, const char *format, struct tm *tm);
函数作用:将以字符串形式表示的时间转为 tm 结构体表示的时间。strptime函数功能与 strftime 函数正好相反。
strptime 函数从左到右按字符进行匹配,一旦匹配格式不正确或者匹配错误就直接返回匹配错误的字符地址。
如果输入的字符串多余需要匹配的格式,返回正确匹配到的字符地址的下一个字符,也就是多出来的字符的首地址。
如果输入的字符串完全匹配正确,则返回值指向字符串的末尾,也就是'\0'的位置。如果匹配过程出错,返回NULL。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("2018-06-24 16:31:01", "%Y-%m-%d %H:%M:%S", &tm);
//打印Sun Jun 24 16:31:01 2018
printf("\ntime: %s\n", asctime(&tm));
memset(&tm, 0, sizeof(struct tm));
strptime("24 Jun 2018 16:31:01", "%d %b %Y %H:%M:%S", &tm);
//打印Sun Jun 24 16:31:01 2018
printf("\ntime: %s\n", asctime(&tm));
}