strptime 将时间字符串转为 struct tm 格式

头文件：#include <time.h>

函数定义： 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 <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>

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));
}