std::chrono:: from_stream (std::chrono::day)

定义于头文件 <chrono>
template < class CharT, class Traits, class Alloc = std:: allocator < CharT > > std:: basic_istream < CharT, Traits > & from_stream ( std:: basic_istream < CharT, Traits > & is, const CharT * fmt, std:: chrono :: day & d, std:: basic_string < CharT, Traits, Alloc > * abbrev = nullptr, std:: chrono :: minutes * offset = nullptr ) ;		(C++20 起)

尝试根据格式字符串 fmt 将输入流 is 解析为 std::chrono::day d 。

表现为一个 UnformattedInputFunction ，但其对 is. gcount ( ) 的影响未作规定。在构造并检查哨兵对象后，尝试根据格式字符串 fmt 将输入流 is 解析至 d 。若解析未能解码有效的 day ，将调用 is. setstate ( std:: ios_base :: failbit ) 且 d 保持不变。

如果格式说明符 %Z 被使用且成功解析，当 abbrev 非空时，解析后的值将被赋给 * abbrev 。如果格式说明符 %z 或其修改变体被使用且成功解析，当 offset 非空时，解析后的值将被赋给 * offset 。

目录 1 参数 2 格式字符串 3 返回值 4 参见

参数

is	-	输入流
fmt	-	格式字符串（详见下文）
d	-	用于保存解析结果的对象
abbrev	-	若非空，指向将保存与 %Z 说明符对应时区缩写或名称的对象的指针
offset	-	若非空，指向将保存与 %z 说明符对应UTC偏移量的对象的指针

格式字符串

格式字符串由零个或多个转换说明符和普通字符组成。每个普通字符（除空白字符和终止空字符外）会匹配输入流中的一个相同字符，如果流中的下一个字符不相等则导致函数执行失败。

每个空白字符匹配输入流中的零个或多个空白字符。

每个未修改的转换说明符以 % 字符开头，后接一个决定说明符行为的字符。部分转换说明符具有修改形式，即在 % 字符后插入 E 或 O 修饰符字符。部分转换说明符具有修改形式，即在 % 字符后插入作为正十进制整数的宽度参数（下文中显示为 N ）。每个转换说明符根据下表将匹配的字符解释为日期和时间类型的组成部分。

格式字符串中，以 % 开头但不符合下列转换说明符的字符序列将被解释为普通字符。

若 from_stream 未能解析格式字符串所指定的全部内容，或解析的信息不足以构成完整结果，或解析过程出现矛盾信息，则会调用 is. setstate ( std:: ios_base :: failbit ) 。

以下转换说明符可用：

转换 说明符	说明
%%	匹配字面量 % 字符。
%n	匹配一个空白字符。
%t	匹配零个或一个空白字符。
年份
%C % N C %EC	将世纪解析为十进制数。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。 修改命令 %EC 解释区域设置的世纪替代表示。
%y % N y %Ey %Oy	解析年份的最后两位十进制数字。若未通过其他方式指定世纪（例如使用 %C），则 [69, 99] 范围内的值被推定为 1969 至 1999 年，[00, 68] 范围内的值被推定为 2000 至 2068 年。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。 修改命令 %Ey 和 %Oy 解释区域设置的替代表示。
%Y % N Y %EY	将年份解析为十进制数。宽度 N 指定读取的最大字符数。默认宽度为 4。允许但不要求前导零。 修改命令 %EY 解释区域设置的替代表示。
月份
%b %B %h	解析区域设置的完整或缩写月份名称（不区分大小写）。
%m % N m %Om	将月份解析为十进制数（一月为 1 ）。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。 修改命令 %Om 解释区域设置的替代表示。
日期
%d % N d %Od %e % N e %Oe	将月份中的日期解析为十进制数。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。 修改命令 %Od 和 %Oe 解释区域设置的替代表示。
星期
%a %A	解析区域设置的完整或缩写星期名称（不区分大小写）。
%u % N u	将 ISO 星期解析为十进制数（1-7），其中周一为 1 。宽度 N 指定读取的最大字符数。默认宽度为 1。允许但不要求前导零。
%w % N w %Ow	将星期解析为十进制数（0-6），其中周日为 0 。宽度 N 指定读取的最大字符数。默认宽度为 1。允许但不要求前导零。 修改命令 %Ow 解释区域设置的替代表示。
ISO 8601 基于周的年份
在 ISO 8601 中，周从周一开始，且一年的第一周必须满足以下要求： 包含 1 月 4 日 包含该年的第一个星期四
%g % N g	解析 ISO 8601 基于周的年份的最后两位十进制数字。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。
%G % N G	将 ISO 8601 基于周的年份解析为十进制数。宽度 N 指定读取的最大字符数。默认宽度为 4。允许但不要求前导零。
%V % N V	将 ISO 8601 年份中的周解析为十进制数。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。
年中的周/日
%j % N j	将年中的日解析为十进制数（1 月 1 日为 1 ）。宽度 N 指定读取的最大字符数。默认宽度为 3。允许但不要求前导零。
%U % N U %OU	将年中的周数解析为十进制数。该年的第一个周日是第 01 周的第一天。该年在此之前的日子属于第 00 周。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。 修改命令 %OU 解释区域设置的替代表示。
%W % N W %OW	将年中的周数解析为十进制数。该年的第一个周一是第 01 周的第一天。该年在此之前的日子属于第 00 周。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。 修改命令 %OW 解释区域设置的替代表示。
日期
%D	等同于 "%m/%d/%y" 。
%F % N F	等同于 "%Y-%m-%d" 。若指定宽度，则仅应用于 %Y 。
%x %Ex	解析区域设置的日期表示。 修改命令 %Ex 解释区域设置的替代日期表示。
一天中的时间
%H % N H %OH	将小时（24 小时制）解析为十进制数。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。 修改命令 %OH 解释区域设置的替代表示。
%I % N I %OI	将小时（12 小时制）解析为十进制数。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。 修改命令 %OI 解释区域设置的替代表示。
%M % N M %OM	将分钟解析为十进制数。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。 修改命令 %OM 解释区域设置的替代表示。
%S % N S %OS	将秒解析为十进制数。宽度 N 指定读取的最大字符数。默认宽度为 2。允许但不要求前导零。 修改命令 %OS 解释区域设置的替代表示。
%p	解析区域设置中与 12 小时制相关的 AM/PM 指示符。
%R	等同于 "%H:%M" 。
%T	等同于 "%H:%M:%S" 。
%r	解析区域设置的 12 小时制时间。
%X %EX	解析区域设置的时间表示。 修改命令 %EX 解释区域设置的替代时间表示。
杂项
%c %Ec	解析区域设置的日期和时间表示。 修改命令 %Ec 解释区域设置的替代日期和时间表示。
%z %Ez %Oz	解析与 UTC 的偏移量，格式为 [+|-]hh[mm] 。例如 -0430 表示比 UTC 晚 4 小时 30 分钟， 04 表示比 UTC 早 4 小时。 修改命令 %Ez 和 %Oz 解析格式 [+|-]h[h][:mm] （即要求小时和分钟之间使用 : 分隔，且小时的前导零可选）。
%Z	解析时区缩写或名称，取最长的字符序列，仅包含字符 A 至 Z 、 a 至 z 、 0 至 9 、 - 、 + 、 _ 和 / 。

返回值

is

参阅

parse (C++20)

从流中解析 chrono 对象 (函数模板)