wcsftime
来自cppreference.com
在标头 <wchar.h> 定义 | ||
| (C95 起) | ||
将来自给定的日历时间 time 的日期和时间信息，按照格式字符串 format，转换成空终止宽字符串 str。最多写入 count 个宽字符。
参数
| str | - | 指向待输出的 wchar_t 数组首元素的指针 |
| count | - | 最大写入宽字符数 |
| format | - | 指向指定转换格式的空终止宽字符串指针。 |
格式字符串
格式字符串由零或更多个说明符和（除 % 外的）普通字符构成。所有普通字符，包括空终止字符，都会被复制到输出字符串而不加修改。每个转换说明符都始于 % 字符，可选地跟随 E 或 O 修饰符（若本地环境不支持则忽略之），后随决定说明符行为的字符。下列格式说明符可用：
| 转换 说明符 | 解释 | 使用的域 |
|---|---|---|
% | 写字面的 %。完整转换说明必须是 %%。 | |
n(C99) | 写换行符 | |
t(C99) | 写水平制表符 | |
| 年 | ||
Y | 以十进制数写年，如 2017 | tm_year |
EY(C99) | 以替用方式写年。例如在 ja_JP 本地环境中，以“平成23年”取代“2011年” | tm_year |
y | 写年的末 2 位十进制数（范围 [00,99]） | tm_year |
Oy(C99) | 以替用数字系统写年的末 2 位数字。例如在 ja_JP 本地环境中以“十一”取代“11” | tm_year |
Ey(C99) | 将年写作从本地环境的替用日历时代 %EC 的偏移（依赖本地环境） | tm_year |
C(C99) | 写年的首 2 位十进制数（范围 [00,99]） | tm_year |
EC(C99) | 以本地环境的替用表示写年号（时代），例如 ja_JP 中的“平成” | tm_year |
G(C99) | 写ISO 8601 基于星期的年，即是包含指定星期的年份。 IS0 8601 中星期以星期一开始，而且一年的首星期必须满足下列要求：
| tm_year, tm_wday, tm_yday |
g(C99) | 写ISO 8601 基于星期的年，即是包含指定星期年份，的后 2 位数（范围 [00,99]） IS0 8601 中星期以星期一开始，而且一年的首星期必须满足下列要求：
| tm_year, tm_wday, tm_yday |
| 月 | ||
b | 写缩写月名，例如 Oct （依赖本地环境） | tm_mon |
Ob(C23) | 以本地环境的替用表示写缩写月名 | tm_mon |
h(C99) | 与 b 同义 | tm_mon |
B | 写完整月名，例如 October （依赖本地环境） | tm_mon |
OB(C23) | 以本地环境的替用表示写适合的完整月名 | tm_mon |
m | 将月写作十进制数（范围 [01,12]） | tm_mon |
Om(C99) | 以替用数字系统写月。例如 ja_JP 本地环境中“十二”取代“12” | tm_mon |
| 星期 | ||
U | 以十进制数写年的星期（星期日是星期的首日）（范围 [00,53]） | tm_year, tm_wday, tm_yday |
OU(C99) | 以替用数值系统写如同用 %U 的年的星期。例如在 ja_JP 本地环境中以“五十二”取代“52” | tm_year, tm_wday, tm_yday |
W | 以十进制数写年的星期（星期一是星期的首日）（范围 [00,53]） | tm_year, tm_wday, tm_yday |
OW(C99) | 以替用数值系统写如同用 %W 的年的星期。例如在 ja_JP 本地环境中以“五十二”取代“52” | tm_year, tm_wday, tm_yday |
V(C99) | 写 ISO 8601 的年的星期（范围[00,53]） IS0 8601 中星期以星期一开始，而且一年的首星期必须满足下列要求：
| tm_year, tm_wday, tm_yday |
OV(C99) | 以替用数值系统写如同用 %V 的年的星期。例如在 ja_JP 本地环境中以“五十二”取代“52” | tm_year, tm_wday, tm_yday |
| 年/月之日 | ||
j | 以十进制数写年的第几日（范围 [001,366]） | tm_yday |
d | 以十进制数写月的第几日（范围 [01,31]） | tm_mday |
Od(C99) | 以替用数字系统写基于零的月的第几日。例如 ja_JP 本地环境中“二十七”取代“27” 单字符前加空格。 | tm_mday |
e(C99) | 以十进制数写月的第几日（范围[01,31]） 单数字前加空格。 | tm_mday |
Oe(C99) | 以替用数字系统写基于一的的月的第几日。例如 ja_JP 本地环境中“二十七”取代“27” 单字符前加空格。 | tm_mday |
| 星期之日 | ||
a | 写缩略的星期日期名，例如 Fri（依赖本地环境） | tm_wday |
A | 写完整的星期日期名，例如 Friday（依赖本地环境） | tm_wday |
w | 以十进制数写星期日期，其中星期日是 0 （范围 [0-6] ） | tm_wday |
Ow(C99) | 用替用数字系统写星期日期，其中星期日是 0。例如 ja_JP 本地环境中“二”取代“2” | tm_wday |
u(C99) | 十进制数写星期日期，其中星期一是 1 （ISO 8601 格式）（范围 [1-7]） | tm_wday |
Ou(C99) | 用替用数字系统写星期日期，其中星期一是 1。例如 ja_JP 本地环境中“二”取代“2” | tm_wday |
| 时、分、秒 | ||
H | 以十进制数写时，24 小时制（范围 [00-23]） | tm_hour |
OH(C99) | 以替用数字系统写 24 小时制的时。例如 ja_JP 本地环境中“十八”取代“18”。 | tm_hour |
I | 以十进制数写时，12 小时制（范围 [01,12]） | tm_hour |
OI(C99) | 以替用数字系统写 12 小时制的时。例如 ja_JP 本地环境中“六”取代“6” | tm_hour |
M | 以十进制数写分（范围 [00,59]） | tm_min |
OM(C99) | 以替用数字系统写分。例如 ja_JP 本地环境中“二十五”取代“25” | tm_min |
S | 以十进制数写秒（范围 [00,60]） | tm_sec |
OS(C99) | 以替用数字系统写秒。例如 ja_JP 本地环境中“二十四”取代“24” | tm_sec |
| 其他 | ||
c | 写标准日期时间字符串。例如 Sun Oct 17 04:41:13 2010 （依赖本地环境） | 全部 |
Ec(C99) | 写替用日期时间字符串。例如 ja_JP 本地环境中“平成23年”取代“2011年” | 全部 |
x | 写本地化的日期表示（依赖本地环境） | 全部 |
Ex(C99) | 写替用日期表示。例如 ja_JP 本地环境中“平成23年”取代“2011年” | 全部 |
X | 写本地化的时间表示，例如 18:40:20 或 6:40:20 PM（依赖本地环境） | 全部 |
EX(C99) | 写替用时间表示（依赖本地环境） | 全部 |
D(C99) | 等价于"%m/%d/%y" | tm_mon, tm_mday, tm_year |
F(C99) | 等价于"%Y-%m-%d"（ISO 8601 日期格式） | tm_mon, tm_mday, tm_year |
r(C99) | 写本地化的 12 小时制时间（依赖本地环境） | tm_hour, tm_min, tm_sec |
R(C99) | 等价于"%H:%M" | tm_hour, tm_min |
T(C99) | 等价于"%H:%M:%S"（ISO 8601 时间格式） | tm_hour, tm_min, tm_sec |
p | 写本地化的 a.m. 或 p.m.（依赖本地环境） | tm_hour |
z(C99) | 以 ISO 8601 格式（例如 -0430）写距 UTC 的偏移，或者倘若时区信息不可用则不写字符 | tm_isdst |
Z | 写依赖本地环境的时区名或缩写，或者若时区信息不可用则不写字符 | tm_isdst |
返回值
成功时，返回写入 str 所指向的宽字符数组的字符数，不包含终止 L'\0'。若在能存储整个字符串前抵达 count，则返回 0，写入内容是未定义的。
示例
运行此代码
#include <locale.h> #include <stdio.h> #include <time.h> #include <wchar.h> int main(void) { wchar_t buff[40]; struct tm my_time = { .tm_year=112, // = 2012 年 .tm_mon=9, // = 10 月 .tm_mday=9, // = 9 日 .tm_hour=8, // = 8 时 .tm_min=10, // = 10 分 .tm_sec=20 // = 20 秒 }; if (wcsftime(buff, sizeof buff, L"%A %c", &my_time)) { printf("%ls\n", buff); } else { puts("wcsftime failed"); } setlocale(LC_ALL, "ja_JP.utf8"); if (wcsftime(buff, sizeof buff, L"%A %c", &my_time)) printf("%ls\n", buff); else puts("wcsftime failed"); }
输出：
Sunday Sun Oct 9 08:10:20 2012 日曜日 2012年10月09日 08時10分20秒
引用
- C23 标准（ISO/IEC 9899:2024）：
- 7.29.5.1 The wcsftime function （第 TBD 页）
- C17 标准（ISO/IEC 9899:2018）：
- 7.29.5.1 The wcsftime function （第 230-231 页）
- C11 标准（ISO/IEC 9899:2011）：
- 7.29.5.1 The wcsftime function （第 439-440 页）
- C99 标准（ISO/IEC 9899:1999）：
- 7.24.5.1 The wcsftime function （第 385-386 页）
参阅
将 struct tm 对象转换成自定义文本表示 (函数) | |
wcsftime 的 C++ 文档 | |