Namespaces
Variants

std::chrono:: from_stream (std::chrono::year_month_day)

From cppreference.net

C++
Date and time library
std::chrono::year_month_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 :: year_month_day & ymd,
std:: basic_string < CharT, Traits, Alloc > * abbrev = nullptr,

std:: chrono :: minutes * offset = nullptr ) ;
(C++20 起)

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

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

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

目录

参数

is - 输入流
fmt - 格式字符串（详见下文）
ymd - 用于保存解析结果的对象
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

参阅

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