上传cppreference
This commit is contained in:
@@ -0,0 +1,381 @@
|
||||
<!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>std::formatter<std::chrono::month_weekday></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-cpp_chrono_month_weekday_formatter skin-cppreference2 action-view cpp-navbar">
|
||||
<div id="cpp-content-base">
|
||||
<div id="content"><a id="top"></a>
|
||||
<h1 id="firstHeading" class="firstHeading"><span style="font-size:0.7em; line-height:130%">std::</span>formatter<small><std::chrono::month_weekday></small></h1>
|
||||
<div id="bodyContent">
|
||||
<div id="contentSub"><span class="subpages">< <a href="cpp.html">cpp</a>‎ | <a href="cpp-chrono.html">chrono</a>‎ | <a href="cpp-chrono-month_weekday.html">month weekday</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><a href="cpp-header-chrono.html"><chrono></a></code></div>
|
||||
</td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
</tr>
|
||||
<tr class="t-dcl t-since-cxx20">
|
||||
<td>
|
||||
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> CharT<span class="sy1">></span><br />
|
||||
<span class="kw1">struct</span> formatter<span class="sy1"><</span>std<span class="sy4">::</span><span class="me2">chrono</span><span class="sy4">::</span><span class="me2">month_weekday</span>, CharT<span class="sy1">></span><span class="sy4">;</span></span></div>
|
||||
</td>
|
||||
<td class="t-dcl-nopad"></td>
|
||||
<td><span class="t-mark-rev t-since-cxx20">(C++20 起)</span></td>
|
||||
</tr>
|
||||
<tr class="t-dcl-sep">
|
||||
<td></td>
|
||||
<td></td>
|
||||
<td></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<p><span class="t-lc">std::formatter</span> 的特化，对 <span class="t-lc">std::chrono::month_weekday</span> 定义格式化规则。</p>
|
||||
<p>通常不直接访问，但通过<a href="cpp-utility-format.html">格式化函数</a>使用 <span class="t-lc">std::formatter</span> 特化。</p>
|
||||
<h3><span class="mw-headline" id=".E6.A0.BC.E5.BC.8F.E8.AF.B4.E6.98.8E">格式说明</span></h3>
|
||||
<p>格式说明拥有形式</p>
|
||||
<table class="t-sdsc-begin">
|
||||
<tr>
|
||||
<td colspan="10" class="t-sdsc-sep"></td>
|
||||
</tr>
|
||||
<tr class="t-sdsc">
|
||||
<td class="t-sdsc-nopad"><span class="t-spar">填充与对齐</span><span class="t-mark">(可选)</span> <span class="t-spar">宽度</span><span class="t-mark">(可选)</span> <span class="t-spar">精度</span><span class="t-mark">(可选)</span> <code><b>L</b></code><span class="t-mark">(可选)</span> <span class="t-spar">时间说明</span><span class="t-mark">(可选)</span></td>
|
||||
<td class="t-sdsc-nopad"></td>
|
||||
<td class="t-sdsc-nopad"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td colspan="10" class="t-sdsc-sep"></td>
|
||||
</tr>
|
||||
</table>
|
||||
<p><span class="t-spar">填充与对齐</span>、 <span class="t-spar">宽度</span> 及 <span class="t-spar">精度</span> 拥有同<a href="cpp-utility-format-formatter.html#.E6.A0.87.E5.87.86.E6.A0.BC.E5.BC.8F.E8.AF.B4.E6.98.8E">标准格式说明</a>中的含义。 <span class="t-spar">精度</span> 仅对表示类型 <code>Rep</code> 为浮点类型的 <span class="t-lc"><a href="cpp-chrono-duration.html">std::chrono::duration</a></span> 类型合法，否则抛出 <span class="t-lc">std::format_error</span> 。</p>
|
||||
<p>用于格式化的本地环境确定如下：</p>
|
||||
<ul>
|
||||
<li>若格式说明中不存在 <code><b>L</b></code> 则为默认的 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="st0">"C"</span></span></span> 本地环境，</li>
|
||||
<li>否则，若有传递给格式化函数的 <span class="t-lc"><a href="cpp-locale-locale.html">std::locale</a></span> 则为其所代表的本地环境，</li>
|
||||
<li>否则（ <code><b>L</b></code> 存在但无传递给格式化函数的 <span class="t-lc"><a href="cpp-locale-locale.html">std::locale</a></span> ）为全局本地环境。</li>
|
||||
</ul>
|
||||
<p><span class="t-spar">时间说明</span> 由一或更多个转换说明符与通常字符（除了 <code>{</code>、 <code>}</code> 与 <code>%</code> ）构成。 <span class="t-spar">时间说明</span> 必须始于一个转换说明符。写入所有通常字符到输出而不修改。每个无修饰的转换说明符始于 <code>%</code> 字符后随一个确定说明符行为的字符。某些转换说明符拥有修饰形式，其中 <code>E</code> 或 <code>O</code> 修饰字符插入到 <code>%</code> 字符后。按描述于下的方式以适合的字符替换每个转换说明符。</p>
|
||||
<p>若 <span class="t-spar">时间说明</span> 为空，则如同以<a href="cpp-chrono-month_weekday-operator_ltlt.html">流化</a>时间对象到 <span class="t-lc"><a href="cpp-io-basic_stringstream.html">std::stringstream</a></span> 类型对象 <code>os</code> ，<a href="cpp-io-ios_base-imbue.html">感染</a>格式化本地环境（ <span class="t-c"><span class="mw-geshi cpp source-cpp">std<span class="sy4">::</span><span class="me2">locale</span><span class="sy4">::</span><span class="me2">classic</span><span class="br0">(</span><span class="br0">)</span></span></span>、传递的 <span class="t-lc"><a href="cpp-locale-locale.html">std::locale</a></span> 对象和 <span class="t-c"><span class="mw-geshi cpp source-cpp">std<span class="sy4">::</span><span class="me2">locale</span><span class="sy4">::</span><span class="me2">global</span><span class="br0">(</span><span class="br0">)</span></span></span> 之一）后复制 <span class="t-c"><span class="mw-geshi cpp source-cpp">os.<span class="me1">str</span><span class="br0">(</span><span class="br0">)</span></span></span> 到输出缓冲，附带按照每个格式说明符的填充和调整一般，格式化时间对象。</p>
|
||||
<p>下列格式说明符可用：</p>
|
||||
<table class="wikitable" style="font-size:85%; max-width:90em;">
|
||||
<tr>
|
||||
<th>转换<br />
|
||||
说明符</th>
|
||||
<th>解释</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%%</code></th>
|
||||
<td>写字面的 <code>%</code> 字符。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%n</code></th>
|
||||
<td>写换行符。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%t</code></th>
|
||||
<td>写水平制表符。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th colspan="3">月</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%b</code><br />
|
||||
<code>%h</code></th>
|
||||
<td>写本地环境的缩写月名。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%B</code></th>
|
||||
<td>写本地环境的完整月名。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%m</code><br />
|
||||
<code>%Om</code></th>
|
||||
<td>按十进制数写月份（一月为 <code>01</code> ）。若结果为单个数位，则前附 0 。
|
||||
<p>修饰的命令 <code>%Om</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th colspan="3">星期之日</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%a</code></th>
|
||||
<td>写本地环境的缩写星期名。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%A</code></th>
|
||||
<td>写本地环境的完整星期名。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%u</code><br />
|
||||
<code>%Ou</code></th>
|
||||
<td>按十进制数写 ISO 星期之日（ 1-7 ），其中星期一为 <code>1</code> 。
|
||||
<p>修饰的命令 <code>%Ou</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%w</code><br />
|
||||
<code>%Ow</code></th>
|
||||
<td>写星期之日为十进制数（ 0-6 ），其中星期日为 <code>0</code> 。
|
||||
<p>修饰的命令 <code>%Ow</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
<p>下列说明符得到辨识，但会导致抛出 <span class="t-lc">std::format_error</span> ：</p>
|
||||
<table class="wikitable" style="font-size:85%; max-width:90em;">
|
||||
<tr>
|
||||
<th>转换<br />
|
||||
说明符</th>
|
||||
<th>解释</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th colspan="3">年</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%C</code><br />
|
||||
<code>%EC</code></th>
|
||||
<td>写年除以 100 向下取整除的结果。若结果为单个十进制位，则前附 0 。
|
||||
<p>修饰的命令 <code>%EC</code> 写本地环境的替用世纪表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%y</code><br />
|
||||
<code>%Oy</code><br />
|
||||
<code>%Ey</code></th>
|
||||
<td>写年的末二位十进制数。若结果为单个数位，则前附 0 。
|
||||
<p>修饰的命令 <code>%Oy</code> 写本地环境的替用表示。</p>
|
||||
<p>修饰的命令 <code>%Ey</code> 写距 <code>%EC</code> 的偏移（仅年）的本地环境替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%Y</code><br />
|
||||
<code>%EY</code></th>
|
||||
<td>按十进制数写年。若结果少于四位，则左填充 0 到四位。
|
||||
<p>修饰的命令 <code>%EY</code> 写本地环境的替用完整年表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th colspan="3">日</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%d</code><br />
|
||||
<code>%Od</code></th>
|
||||
<td>按十进制数写月之日。若结果为单个十进制位，则前附 0 。
|
||||
<p>修饰的命令 <code>%Od</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%e</code><br />
|
||||
<code>%Oe</code></th>
|
||||
<td>按十进制数写月之日。若结果为单个十进制位，则前附空格。
|
||||
<p>修饰的命令 <code>%Oe</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th colspan="3">基于 ISO 8601 星期的年</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<td colspan="3">
|
||||
<p>ISO 8601 星期始于星期一而年的第一星期必须满足下列要求：</p>
|
||||
<ul>
|
||||
<li>包含 1 月 4 日</li>
|
||||
<li>包含该年的首个星期四</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%g</code></th>
|
||||
<td>写基于 ISO 8601 星期的年的后二位十进制数。若结果为单个数位，则前附 0 。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%G</code></th>
|
||||
<td>按十进制数写基于 ISO 8601 星期的年。若结果少于四位，则左填充 0 到四位。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%V</code><br />
|
||||
<code>%OV</code></th>
|
||||
<td>按十进制数年的 ISO 8601 星期。若结果为单个数位，则前附 0 。
|
||||
<p>修饰的命令 <code>%OV</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th colspan="3">年之星期/日</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%j</code></th>
|
||||
<td>按十进制数写年的日（ 1 月 1 日为 <code>001</code> ）。若结果少于三位，则左填充 0 到三位。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%U</code><br />
|
||||
<code>%OU</code></th>
|
||||
<td>按十进制数写年的星期数。该年的首个星期日为 01 星期的首日。同年中之前的日在 00 星期中。若结果为单个数位，则前附 0 。
|
||||
<p>修饰的命令 <code>%OU</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%W</code><br />
|
||||
<code>%OW</code></th>
|
||||
<td>按十进制数写年的星期数。该年的首个星期一为 01 星期的首日。同年中之前的日在 00 星期中。若结果为单个数位，则前附 0 。
|
||||
<p>修饰的命令 <code>%OW</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th colspan="3">日期</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%D</code></th>
|
||||
<td>等价于 <code><b>"%m/%d/%y"</b></code> 。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%F</code></th>
|
||||
<td>等价于 <code><b>"%Y-%m-%d"</b></code> 。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%x</code><br />
|
||||
<code>%Ex</code></th>
|
||||
<td>写本地环境的日期表示。
|
||||
<p>修饰的命令 <code>%Ex</code> 产生本地环境的替用日期表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th colspan="3">当天时刻</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%H</code><br />
|
||||
<code>%OH</code></th>
|
||||
<td>按十进制数字写时（ 24 小时时钟）。若结果为单个数位，则前附 0 。
|
||||
<p>修饰的命令 <code>%OH</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%I</code><br />
|
||||
<code>%OI</code></th>
|
||||
<td>按十进制数字写时（ 12 小时时钟）。若结果为单个数位，则前附 0 。
|
||||
<p>修饰的命令 <code>%OI</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%M</code><br />
|
||||
<code>%OM</code></th>
|
||||
<td>按十进制数字写分。若结果为单个数位，则前附 0 。
|
||||
<p>修饰的命令 <code>%OM</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%S</code><br />
|
||||
<code>%OS</code></th>
|
||||
<td>按十进制数字写秒。若结果为单个数位，则前附 0 。
|
||||
<p>若输入的精度不能准确地以秒表示，则格式为 fixed 格式且精度匹配输入精度的十进制浮点数（或若不能在 18 位小数内转换到浮点数十进制秒，则为到微秒精度）。用作小数点的字符按照本地环境本地化。</p>
|
||||
<p>修饰的命令 <code>%OS</code> 写本地环境的替用表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%p</code></th>
|
||||
<td>写与 12 小时时钟相关的 AM/PM 设计的本地环境版本。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%R</code></th>
|
||||
<td>等价于 <code><b>"%H:%M"</b></code> 。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%T</code></th>
|
||||
<td>等价于 <code><b>"%H:%M:%S"</b></code> 。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%r</code></th>
|
||||
<td>写本地环境的 12 小时时钟时间。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%X</code><br />
|
||||
<code>%EX</code></th>
|
||||
<td>写本地环境的时间表示。
|
||||
<p>修饰的命令 <code>%EX</code> 写本地环境的替用时间表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th colspan="3">时长计数</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%Q</code></th>
|
||||
<td>写时长的计次数，即经由 <a href="cpp-chrono-duration-count.html"><tt>count()</tt></a> 获得的值。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%q</code></th>
|
||||
<td>写 <a href="cpp-chrono-duration-operator_ltlt.html"><tt>operator<<()</tt></a> 中指定的时长单位后缀。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th colspan="3">时区</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%z</code><br />
|
||||
<code>%Ez</code><br />
|
||||
<code>%Oz</code></th>
|
||||
<td>以 ISO 8601 格式写自 UTC 的偏移。例如 <code>-0430</code> 表示 UTC 后 4 小时 30 分。若偏移为 0 ，则使用 <code>+0000</code> 。
|
||||
<p>修饰的命令 <code>%Ez</code> 与 <code>%Oz</code> 在时与分间插入 <code>:</code> （例如 <code>-04:30</code> ）。</p>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%Z</code></th>
|
||||
<td>写时区缩写。</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th colspan="3">杂项</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<th><code>%c</code><br />
|
||||
<code>%Ec</code></th>
|
||||
<td>写本地环境的日期与时间表示。
|
||||
<p>修饰的命令 <code>%Ec</code> 写本地环境的替用日期与时间表示。</p>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
<h3><span class="mw-headline" id=".E7.A4.BA.E4.BE.8B">示例</span></h3>
|
||||
<table class="metadata plainlinks ambox mbox-small-left ambox-notice" style="">
|
||||
<tr>
|
||||
<td class="mbox-empty-cell"></td>
|
||||
<td class="mbox-text" style="">本节未完成<br />
|
||||
原因：暂无示例</td>
|
||||
</tr>
|
||||
</table>
|
||||
<h3><span class="mw-headline" id=".E7.BC.BA.E9.99.B7.E6.8A.A5.E5.91.8A">缺陷报告</span></h3>
|
||||
<p>下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。</p>
|
||||
<table class="dsctable" style="font-size:0.8em">
|
||||
<tr>
|
||||
<th>DR</th>
|
||||
<th>应用于</th>
|
||||
<th>出版时的行为</th>
|
||||
<th>正确行为</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a rel="nofollow" class="external text" href="https://wg21.link/P2372R3">P2372R3</a></td>
|
||||
<td>C++20</td>
|
||||
<td>默认使用给定的本地环境</td>
|
||||
<td>需要 <code><b>L</b></code> 以使用本地环境</td>
|
||||
</tr>
|
||||
</table>
|
||||
<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="cpp-utility-format-format.html"><span class="t-lines"><span>format</span></span></a></div>
|
||||
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx20">(C++20)</span></span></span></div>
|
||||
</div>
|
||||
</td>
|
||||
<td>在新 string 中存储参数的格式化表示<br />
|
||||
<span class="t-mark">(函数模板)</span></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div>
|
||||
<div class="visualClear"></div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user