529 lines
30 KiB
HTML
529 lines
30 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="zh" dir="ltr" class="client-nojs" xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh">
|
|
<head><meta http-equiv="x-ua-compatible" content="ie=edge">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>wcsftime</title>
|
|
<link rel="stylesheet" href="ext.css" />
|
|
<link rel="stylesheet" href="site_modules.css" />
|
|
</head>
|
|
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-c_chrono_wcsftime skin-cppreference2 action-view cpp-navbar">
|
|
<div id="cpp-content-base">
|
|
<div id="content"><a id="top"></a>
|
|
<h1 id="firstHeading" class="firstHeading">wcsftime</h1>
|
|
<div id="bodyContent">
|
|
<div id="contentSub"><span class="subpages">< <a href="c.html">c</a>‎ | <a href="c-chrono.html">chrono</a></span></div>
|
|
<div id="mw-content-text" lang="zh" dir="ltr" class="mw-content-ltr" xml:lang="zh">
|
|
<table class="t-dcl-begin">
|
|
<tbody>
|
|
<tr class="t-dsc-header">
|
|
<td>
|
|
<div>定义于头文件 <code><wchar.h></code></div>
|
|
</td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
<tr class="t-dcl">
|
|
<td>
|
|
<div><span class="mw-geshi c source-c"><a href="c-types-size_t.html"><span class="kw100">size_t</span></a> wcsftime<span class="br0">(</span> <span class="kw4">wchar_t</span><span class="sy2">*</span> str, <a href="c-types-size_t.html"><span class="kw100">size_t</span></a> count, <span class="kw4">const</span> <span class="kw4">wchar_t</span><span class="sy2">*</span> format, <a href="c-chrono-tm.html"><span class="kw522">tm</span></a><span class="sy2">*</span> <a href="c-chrono-time.html"><span class="kw513">time</span></a> <span class="br0">)</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td class="t-dcl-nopad"></td>
|
|
<td><span class="t-mark-rev t-since-c95">(C95 起)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl-sep">
|
|
<td></td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>将来自给定的日历时间 <code>time</code> 的日期和时间信息，按照格式字符串 <code>format</code> ，转换成空终止宽字符串 <code>str</code> 。最多写入 <code>count</code> 个宽字符。</p>
|
|
<h3><span class="mw-headline" id=".E5.8F.82.E6.95.B0">参数</span></h3>
|
|
<table class="t-par-begin">
|
|
<tr class="t-par">
|
|
<td>str</td>
|
|
<td>-</td>
|
|
<td>指向待输出的 <code>wchar_t</code> 数组首元素的指针</td>
|
|
</tr>
|
|
<tr class="t-par">
|
|
<td>count</td>
|
|
<td>-</td>
|
|
<td>最大写入宽字符数</td>
|
|
</tr>
|
|
<tr class="t-par">
|
|
<td>format</td>
|
|
<td>-</td>
|
|
<td>指向指定转换格式的空终止宽字符串指针。
|
|
<p>格式字符串由零或更多个说明符和通常字符（除 <code>%</code> ）构成。所有通常字符，包括空终止字符，都会被复制到输出字符串而不加修改。每个转换说明符都始于 <code>%</code> 字符，可选地跟随 <code>E</code> 或 <code>O</code> 修饰符（若本地环境不支持则忽略），后随决定修饰符行为的字符。下列修饰符格式可用：</p>
|
|
<table class="wikitable" style="font-size:85%; max-width:90em;">
|
|
<tr>
|
|
<th>转换<br />
|
|
说明符</th>
|
|
<th>解释</th>
|
|
<th>使用的域</th>
|
|
</tr>
|
|
<tr>
|
|
<th><code>%</code></th>
|
|
<td>写字面的 <code>%</code> 。完整转换说明必须是 <code>%%</code> 。</td>
|
|
<td></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>n</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>写换行符</td>
|
|
<td></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>t</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>写水平制表符</td>
|
|
<td></td>
|
|
</tr>
|
|
<tr>
|
|
<th colspan="3">年</th>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Y</code></th>
|
|
<td>以 4 位十进制数写<b>年</b>。</td>
|
|
<td><code><b>tm_year</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>EY</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用方式写<b>年</b>。例如在 ja_JP 本地环境中，以“平成23年”取代“2011年”。</td>
|
|
<td><code><b>tm_year</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>y</code></th>
|
|
<td>写<b>年</b>的末 2 位十进制数（范围<code>[00,99]</code>）。</td>
|
|
<td><code><b>tm_year</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Oy</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用数字系统写<b>年</b>的末 2 位数字。例如在 ja_JP 本地环境中以“十一”取代“11”。</td>
|
|
<td><code><b>tm_year</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Ey</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>将<b>年</b>写作从本地环境的替用时期 <code>%EC</code> 的偏移（本地环境依赖）。</td>
|
|
<td><code><b>tm_year</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>C</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>写<b>年</b>的首 2 位十进制数（范围 <code>[00,99]</code> ）。</td>
|
|
<td><code><b>tm_year</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>EC</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以本地环境的替用表示写<b>年份基底（时期）</b>，例如 ja_JP 中的“平成”。</td>
|
|
<td><code><b>tm_year</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>G</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>写<b>基于 ISO 8601 的年</b>，即是包含指定星期的年份。
|
|
<p>IS0 8601 中星期以星期一开始，而且一年的首星期必须满足下列要求：</p>
|
|
<ul>
|
|
<li>包含 1 月 4 日</li>
|
|
<li>包含一年的首个星期四</li>
|
|
</ul>
|
|
</td>
|
|
<td><code><b>tm_year</b></code>, <code><b>tm_wday</b></code>, <code><b>tm_yday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>g</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>写<b>基于 ISO 8601 的年</b>，即是包含指定星期年份，的后 2 位数（范围 <code>[00,99]</code> ）。
|
|
<p>IS0 8601 中星期以星期一开始，而且一年的首星期必须满足下列要求：</p>
|
|
<ul>
|
|
<li>包含 1 月 4 日</li>
|
|
<li>包含一年的首个星期四</li>
|
|
</ul>
|
|
</td>
|
|
<td><code><b>tm_year</b></code>, <code><b>tm_wday</b></code>, <code><b>tm_yday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th colspan="3">月</th>
|
|
</tr>
|
|
<tr>
|
|
<th><code>b</code></th>
|
|
<td>写<b>缩略月</b>名，例如 <code>Oct</code> （本地环境依赖）。</td>
|
|
<td><code><b>tm_mon</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Ob</code><br />
|
|
<span class="t-mark-rev t-since-c23">(C23)</span></th>
|
|
<td>以本地环境的替用表示写<b>缩写月</b>名</td>
|
|
<td><code><b>tm_mon</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>h</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>与 <code>b</code> 同意。</td>
|
|
<td><code><b>tm_mon</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>B</code></th>
|
|
<td>写<b>完整月</b>名，例如 <code>October</code> （本地环境依赖）。</td>
|
|
<td><code><b>tm_mon</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>OB</code><br />
|
|
<span class="t-mark-rev t-since-c23">(C23)</span></th>
|
|
<td>以本地环境的替用表示写适合的<b>完整月</b>名</td>
|
|
<td><code><b>tm_mon</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>m</code></th>
|
|
<td>将<b>月</b>写作十进制数（范围 <code>[01,12]</code> ）。</td>
|
|
<td><code><b>tm_mon</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Om</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用数字系统写<b>月</b>。例如 ja_JP 本地环境中“十二”取代“12”。</td>
|
|
<td><code><b>tm_mon</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th colspan="3">星期</th>
|
|
</tr>
|
|
<tr>
|
|
<th><code>U</code></th>
|
|
<td>以十进制数写<b>年的星期</b>（星期日是星期的首日）（范围 <code>[00,53]</code> ）。</td>
|
|
<td><code><b>tm_year</b></code>, <code><b>tm_wday</b></code>, <code><b>tm_yday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>OU</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用数值系统写如同用 <code>%U</code> 的<b>年的星期</b>。例如“五十二”在 ja_JP 本地环境中取代“52”。</td>
|
|
<td><code><b>tm_year</b></code>, <code><b>tm_wday</b></code>, <code><b>tm_yday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>W</code></th>
|
|
<td>以十进制数写<b>年的星期</b>（星期一是星期的首日）（范围 <code>[00,53]</code> ）。</td>
|
|
<td><code><b>tm_year</b></code>, <code><b>tm_wday</b></code>, <code><b>tm_yday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>OW</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用数值系统写如同用 <code>%W</code> 的<b>年的第星期</b>。例如“五十二”在 ja_JP 本地环境中取代“52”。</td>
|
|
<td><code><b>tm_year</b></code>, <code><b>tm_wday</b></code>, <code><b>tm_yday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>V</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>写 <b>ISO 8601 的年的星期</b>（范围<code>[00,53]</code>）。
|
|
<p>IS0 8601 中星期以星期一开始，而且一年的首星期必须满足下列要求：</p>
|
|
<ul>
|
|
<li>包含 1 月 4 日</li>
|
|
<li>包含一年的首个星期四</li>
|
|
</ul>
|
|
</td>
|
|
<td><code><b>tm_year</b></code>, <code><b>tm_wday</b></code>, <code><b>tm_yday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>OV</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用数值系统写如同用 <code>%V</code> 的<b>年的星期</b>。例如“五十二”在 ja_JP 本地环境中取代“52”。</td>
|
|
<td><code><b>tm_year</b></code>, <code><b>tm_wday</b></code>, <code><b>tm_yday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th colspan="3">年/月之日</th>
|
|
</tr>
|
|
<tr>
|
|
<th><code>j</code></th>
|
|
<td>以十进制数写<b>年的第几日</b>（范围 <code>[001,366]</code> ）。</td>
|
|
<td><code><b>tm_yday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>d</code></th>
|
|
<td>以十进制数写<b>月的第几日</b>（范围 <code>[01,31]</code> ）。</td>
|
|
<td><code><b>tm_mday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Od</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用数字系统写零基的<b>月的第几日</b>。例如 ja_JP 本地环境中“二十七”取代“ 27 ”。
|
|
<p>单字符前加空格。</p>
|
|
</td>
|
|
<td><code><b>tm_mday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>e</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以十进制数写<b>月的第几日</b>（范围<code>[01,31]</code>）。
|
|
<p>单数字前加空格。</p>
|
|
</td>
|
|
<td><code><b>tm_mday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Oe</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用数字系统写一基的<b>月的第几日</b>。例如 ja_JP 本地环境中“二十七”取代“27”。
|
|
<p>单字符前加空格。</p>
|
|
</td>
|
|
<td><code><b>tm_mday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th colspan="3">星期之日</th>
|
|
</tr>
|
|
<tr>
|
|
<th><code>a</code></th>
|
|
<td>写<b>缩略的星期日期</b>名，例如 <code>Fri</code> （本地环境依赖）。</td>
|
|
<td><code><b>tm_wday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>A</code></th>
|
|
<td>写<b>完整的星期日期</b>名，例如 <code>Friday</code> （本地环境依赖）。</td>
|
|
<td><code><b>tm_wday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>w</code></th>
|
|
<td>以十进制数写<b>星期日期</b>，其中星期日是 <code>0</code> （范围 <code>[0-6]</code> ）。</td>
|
|
<td><code><b>tm_wday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Ow</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>用替用数字系统写<b>星期日期</b>，其中星期日是 <code>0</code> 。例如 ja_JP 本地环境中“二”取代“2”。</td>
|
|
<td><code><b>tm_wday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>u</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>十进制数写<b>星期日期</b>，其中星期一是 <code>1</code> （ ISO 8601 格式）（范围 <code>[1-7]</code> ）。</td>
|
|
<td><code><b>tm_wday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Ou</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>用替用数字系统写<b>星期日期</b>，其中星期一是 <code>1</code> 。例如 ja_JP 本地环境中“二”取代“2”。</td>
|
|
<td><code><b>tm_wday</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th colspan="3">时、分、秒</th>
|
|
</tr>
|
|
<tr>
|
|
<th><code>H</code></th>
|
|
<td>以十进制数写<b>时</b>， 24 小时制（范围 <code>[00-23]</code> ）。</td>
|
|
<td><code><b>tm_hour</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>OH</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用数字系统写 24 小时制的<b>时</b>。例如 ja_JP 本地环境中“十八”取代“18”。</td>
|
|
<td><code><b>tm_hour</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>I</code></th>
|
|
<td>以十进制数写<b>时</b>， 12 小时制（范围 <code>[01,12]</code> ）。</td>
|
|
<td><code><b>tm_hour</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>OI</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用数字系统写 12 小时制的<b>时</b>。例如 ja_JP 本地环境中“六”取代“6”。</td>
|
|
<td><code><b>tm_hour</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>M</code></th>
|
|
<td>以十进制数写<b>分</b>（范围 <code>[00,59]</code> ）。</td>
|
|
<td><code><b>tm_min</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>OM</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用数字系统写<b>分</b>。例如 ja_JP 本地环境中“二十五”取代“25”。</td>
|
|
<td><code><b>tm_min</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>S</code></th>
|
|
<td>以十进制数写<b>秒</b>（范围 <code>[00,60]</code> ）。</td>
|
|
<td><code><b>tm_sec</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>OS</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以替用数字系统写<b>秒</b>。例如 ja_JP 本地环境中“二十四”取代“24”。</td>
|
|
<td><code><b>tm_sec</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th colspan="3">其他</th>
|
|
</tr>
|
|
<tr>
|
|
<th><code>c</code></th>
|
|
<td>写<b>标准日期时间字符串</b>。例如 <code>Sun Oct 17 04:41:13 2010</code> （本地环境依赖）。</td>
|
|
<td>全部</td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Ec</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>写<b>替用日期时间字符串</b>。例如 ja_JP 本地环境中“平成23年”取代“2011年”。</td>
|
|
<td>全部</td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>x</code></th>
|
|
<td>写本地化的<b>日期表示</b>（本地环境依赖）。</td>
|
|
<td>全部</td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Ex</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>写<b>替用日期表示</b>。例如 ja_JP 本地环境中“平成23年”取代“2011年”。</td>
|
|
<td>全部</td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>X</code></th>
|
|
<td>写本地化的<b>时间表示</b>，例如 18:40:20 或 6:40:20 PM （本地环境依赖）。</td>
|
|
<td>全部</td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>EX</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>写<b>替用时间表示</b>（本地环境依赖）。</td>
|
|
<td>全部</td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>D</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>等价于<b>"%m/%d/%y"</b>。</td>
|
|
<td><code><b>tm_mon</b></code>, <code><b>tm_mday</b></code>, <code><b>tm_year</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>F</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>等价于<b>"%Y-%m-%d"</b>（ ISO 8601 日期格式）。</td>
|
|
<td><code><b>tm_mon</b></code>, <code><b>tm_mday</b></code>, <code><b>tm_year</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>r</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>写本地化的 <b>12 小时制</b>时间（本地环境依赖）。</td>
|
|
<td><code><b>tm_hour</b></code>, <code><b>tm_min</b></code>, <code><b>tm_sec</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>R</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>等价于<b>"%H:%M"</b>。</td>
|
|
<td><code><b>tm_hour</b></code>, <code><b>tm_min</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>T</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>等价于<b>"%H:%M:%S"</b>（ ISO 8601 时间格式）。</td>
|
|
<td><code><b>tm_hour</b></code>, <code><b>tm_min</b></code>, <code><b>tm_sec</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>p</code></th>
|
|
<td>写本地化的 <b>a.m.</b> 或 <b>p.m.</b> （本地环境依赖）。</td>
|
|
<td><code><b>tm_hour</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>z</code><br />
|
|
<span class="t-mark-rev t-since-c99">(C99)</span></th>
|
|
<td>以 ISO 8601 格式（例如 <code>-0430</code> ）写<b>距 UTC 的偏移</b>，或者倘若时区信息不可用则不写字符。</td>
|
|
<td><code><b>tm_isdst</b></code></td>
|
|
</tr>
|
|
<tr>
|
|
<th><code>Z</code></th>
|
|
<td>写依赖本地环境的<b>时区名或缩写</b>，或者若时区信息不可用则不写字符。</td>
|
|
<td><code><b>tm_isdst</b></code></td>
|
|
</tr>
|
|
</table>
|
|
<p><br /></p>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<h3><span class="mw-headline" id=".E8.BF.94.E5.9B.9E.E5.80.BC">返回值</span></h3>
|
|
<p>成功时，返回写入 <code>str</code> 所指向的宽字符数组的字符数，不包含终止 <span class="t-c"><span class="mw-geshi c source-c">L<span class="st0">'<span class="es5">\0</span>'</span></span></span> 。若在能存储整个字符串前抵达 <code>count</code> ，则返回 <span class="t-c"><span class="mw-geshi c source-c">​<span class="nu0">0</span>​</span></span> ，写入内容是未定义的。</p>
|
|
<h3><span class="mw-headline" id=".E7.A4.BA.E4.BE.8B">示例</span></h3>
|
|
<div class="t-example">
|
|
<div class="t-example-live-link"></div>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="c source-c">
|
|
<pre class="de1"><span class="co2">#include <stdio.h></span>
|
|
<span class="co2">#include <time.h></span>
|
|
<span class="co2">#include <wchar.h></span>
|
|
<span class="co2">#include <locale.h></span>
|
|
|
|
<span class="kw4">int</span> main<span class="br0">(</span><span class="kw4">void</span><span class="br0">)</span>
|
|
<span class="br0">{</span>
|
|
<span class="kw4">wchar_t</span> buff<span class="br0">[</span><span class="nu0">40</span><span class="br0">]</span><span class="sy4">;</span>
|
|
<span class="kw1">struct</span> <a href="c-chrono-tm.html"><span class="kw522">tm</span></a> my_time <span class="sy1">=</span> <span class="br0">{</span> .<span class="me1">tm_year</span><span class="sy1">=</span><span class="nu0">112</span>, <span class="co1">// = 2012 年</span>
|
|
.<span class="me1">tm_mon</span><span class="sy1">=</span><span class="nu0">9</span>, <span class="co1">// = 10 月</span>
|
|
.<span class="me1">tm_mday</span><span class="sy1">=</span><span class="nu0">9</span>, <span class="co1">// = 9 日</span>
|
|
.<span class="me1">tm_hour</span><span class="sy1">=</span><span class="nu0">8</span>, <span class="co1">// = 8 时</span>
|
|
.<span class="me1">tm_min</span><span class="sy1">=</span><span class="nu0">10</span>, <span class="co1">// = 10 分</span>
|
|
.<span class="me1">tm_sec</span><span class="sy1">=</span><span class="nu0">20</span> <span class="co1">// = 20 秒</span>
|
|
<span class="br0">}</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">if</span> <span class="br0">(</span>wcsftime<span class="br0">(</span>buff, <span class="kw4">sizeof</span> buff, L<span class="st0">"%A %c"</span>, <span class="sy3">&</span>my_time<span class="br0">)</span><span class="br0">)</span> <span class="br0">{</span>
|
|
<a href="c-io-fprintf.html"><span class="kw850">printf</span></a><span class="br0">(</span><span class="st0">"%ls<span class="es1">\n</span>"</span>, buff<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="br0">}</span> <span class="kw1">else</span> <span class="br0">{</span>
|
|
<a href="c-io-puts.html"><span class="kw835">puts</span></a><span class="br0">(</span><span class="st0">"wcsftime failed"</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="br0">}</span>
|
|
|
|
<a href="c-locale-setlocale.html"><span class="kw900">setlocale</span></a><span class="br0">(</span><a href="c-locale-LC_categories.html"><span class="kw903">LC_ALL</span></a>, <span class="st0">"ja_JP.utf8"</span><span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">if</span> <span class="br0">(</span>wcsftime<span class="br0">(</span>buff, <span class="kw4">sizeof</span> buff, L<span class="st0">"%A %c"</span>, <span class="sy3">&</span>my_time<span class="br0">)</span><span class="br0">)</span> <span class="br0">{</span>
|
|
<a href="c-io-fprintf.html"><span class="kw850">printf</span></a><span class="br0">(</span><span class="st0">"%ls<span class="es1">\n</span>"</span>, buff<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="br0">}</span> <span class="kw1">else</span> <span class="br0">{</span>
|
|
<a href="c-io-puts.html"><span class="kw835">puts</span></a><span class="br0">(</span><span class="st0">"wcsftime failed"</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="br0">}</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
<p>输出：</p>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="text source-text">
|
|
<pre class="de1">Sunday Sun Oct 9 08:10:20 2012
|
|
日曜日 2012年10月09日 08時10分20秒</pre></div>
|
|
</div>
|
|
</div>
|
|
<h3><span class="mw-headline" id=".E5.BC.95.E7.94.A8">引用</span></h3>
|
|
<div class="t-ref-std-11">
|
|
<ul>
|
|
<li>C11 标准（ISO/IEC 9899:2011）：</li>
|
|
</ul>
|
|
<dl>
|
|
<dd>
|
|
<ul>
|
|
<li>7.29.5.1 The wcsftime function (p: 439-440)</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
<div class="t-ref-std-c99">
|
|
<ul>
|
|
<li>C99 标准（ISO/IEC 9899:1999）：</li>
|
|
</ul>
|
|
<dl>
|
|
<dd>
|
|
<ul>
|
|
<li>7.24.5.1 The wcsftime function (p: 385-386)</li>
|
|
</ul>
|
|
</dd>
|
|
</dl>
|
|
</div>
|
|
<h3><span class="mw-headline" id=".E5.8F.82.E9.98.85">参阅</span></h3>
|
|
<table class="t-dsc-begin">
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="c-chrono-strftime.html"><span class="t-lines"><span>strftime</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>将 <code>struct tm</code> 对象转换成自定义文本表示<br />
|
|
<span class="t-mark">(函数)</span></td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="visualClear"></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|