C++ <ctime> 库函数 - strftime()
size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)
根据 format 中定义的格式化规则，格式化结构 timeptr 表示的时间，并把它存储在 str 中
头文件
#include <ctime>
函数原型
size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)
参数
| 参数 | 说明 |
|---|---|
| str | 指向目标数组的指针，用来复制产生的 C 字符串 |
| maxsize | 复制到 str 的最大字符数 |
| format | 这是 C 字符串，包含了普通字符和特殊格式说明符的任何组合 |
| timeptr | 指向 tm 结构的指针 |
格式说明符由函数替换为表示 tm 中所指定时间的相对应值
格式说明符
| 说明符 | 替换为 | 范例 |
|---|---|---|
| %a | 缩写的星期几名称 | Sun |
| %A | 完整的星期几名称 | Sunday |
| %b | 缩写的月份名称 | Mar |
| %B | 完整的月份名称 | March |
| %c | 日期和时间表示法 | Sun Aug 19 02:56:02 2012 |
| %d | 一月中的第几天（01-31） | 19 |
| %H | 24 小时格式的小时（00-23） | 14 |
| %I | 12 小时格式的小时（01-12） | 05 |
| %j | 一年中的第几天（001-366） | 231 |
| %m | 十进制数表示的月份（01-12） | 08 |
| %M | 分（00-59） | 55 |
| %p | AM 或 PM 名称 | PM |
| %S | 秒（00-61） | 02 |
| %U | 一年中的第几周 以第一个星期日作为第一周的第一天（00-53） |
33 |
| %w | 十进制数表示的星期几， 星期日表示为 0（0-6） |
4 |
| %W | 一年中的第几周 以第一个星期一作为第一周的第一天（00-53） |
34 |
| %x | 日期表示法 | 08/19/12 |
| %X | 时间表示法 | 02:50:06 |
| %y | 年份，最后两个数字（00-99） | 01 |
| %Y | 年份 | 2012 |
| %Z | 时区的名称或缩写 | CDT |
| %% | 一个 % 符号 | % |
结构体 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 int tm_year; // 自 1900 起的年数 int tm_wday; // 一周中的第几天，范围从 0 到 6 int tm_yday; // 一年中的第几天，范围从 0 到 365 int tm_isdst; // 夏令时 };
返回值
如果产生的 char *字符串小于 size 个字符（包括空结束字符），则会返回复制到 str 中的字符总数（不包括空结束字符），否则返回 0
范例
/** * file: main.cpp * author: 简单教程(www.twle.cn) * * Copyright © 2015-2065 www.twle.cn. All rights reserved. */ #include <iostream> #include <ctime> int main () { time_t rawtime; struct tm *info; char buffer[80]; time( &rawtime ); info = localtime( &rawtime ); strftime(buffer,80,"%x - %I:%M%p", info); std::cout << "格式化后的日期时间 : " << buffer << std::endl; return 0; }
使用 g++ main.cpp && ./a.out 命令编译运行上面代码，输出结果如下
格式化后的日期时间 : 04/10/18 - 11:39AM