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