std::chrono:: from_stream (std::chrono::file_time)

template < class CharT, class Traits, class Duration, class Alloc = std:: allocator < CharT > > std:: basic_istream < CharT, Traits > & from_stream ( std:: basic_istream < CharT, Traits > & is, const CharT * fmt, std:: chrono :: file_time < Duration > & tp, std:: basic_string < CharT, Traits, Alloc > * abbrev = nullptr, std:: chrono :: minutes * offset = nullptr ) ;		(C++20 起)

尝试根据格式字符串 fmt 将输入流 is 解析为时间点 tp 。

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

如果格式说明符 %Z 被使用且成功解析，且 abbrev 非空，则解析后的值将被赋给 * abbrev 。如果格式说明符 %z 或其修饰变体被使用且成功解析，且 offset 非空，则解析后的值将被赋给 * offset ，且解析得到的偏移量将在计算时间差之前从已解析的时间戳中减去，最终将差值赋给 tp 。

目录 1 参数 2 格式字符串 3 返回值 4 示例 5 另请参阅

参数

is	-	输入流
fmt	-	格式字符串（详见下文）
tp	-	用于存储解析结果的时间点对象
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 指定要读取的最大字符数。如果 Duration 可转换为 std::chrono::seconds ，则默认宽度为 2；否则由 Duration 的十进制精度确定，且该字段被解释为固定格式的 long double，小数点字符由区域设置确定（如果遇到）。允许但不要求前导零。 修改命令 %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 对象 (函数模板)