Namespaces
Variants

std::chrono:: parse

From cppreference.net
C++
Date and time library
定义于头文件 <chrono>
template < class CharT, class Parsable >
/* 未指定 */ parse ( const CharT * fmt, Parsable & tp ) ;
(1) (C++20 起)
template < class CharT, class Traits, class Alloc, class Parsable >

/* 未指定 */ parse ( const std:: basic_string < CharT, Traits, Alloc > & fmt,

Parsable & tp ) ;
(2) (C++20 起)
template < class CharT, class Traits, class Alloc, class Parsable >

/* 未指定 */ parse ( const CharT * fmt, Parsable & tp,

std:: basic_string < CharT, Traits, Alloc > & abbrev ) ;
(3) (C++20 起)
template < class CharT, class Traits, class Alloc, class Parsable >

/* 未指定 */ parse ( const std:: basic_string < CharT, Traits, Alloc > & fmt,
Parsable & tp,

std:: basic_string < CharT, Traits, Alloc > & abbrev ) ;
(4) (C++20 起)
template < class CharT, class Parsable >

/* 未指定 */ parse ( const CharT * fmt, Parsable & tp,

std:: chrono :: minutes & offset ) ;
(5) (C++20 起)
template < class CharT, class Traits, class Alloc, class Parsable >

/* 未指定 */ parse ( const std:: basic_string < CharT, Traits, Alloc > & fmt,

Parsable & tp, std:: chrono :: minutes & offset ) ;
(6) (C++20 起)
template < class CharT, class Traits, class Alloc, class Parsable >

/* 未指定 */ parse ( const CharT * fmt, Parsable & tp,
std:: basic_string < CharT, Traits, Alloc > & abbrev,

std:: chrono :: minutes & offset ) ;
(7) (C++20 起)
template < class CharT, class Traits, class Alloc, class Parsable >

/* 未指定 */ parse ( const std:: basic_string < CharT, Traits, Alloc > & fmt,
Parsable & tp,
std:: basic_string < CharT, Traits, Alloc > & abbrev,

std:: chrono :: minutes & offset ) ;
(8) (C++20 起)

返回一个未指定类型的对象 manip ，使得对于给定的 std:: basic_istream < CharT, Traits > 对象 is ，表达式 is >> manip 将调用 from_stream （非限定调用，以启用 实参依赖查找 ），调用方式如下：

1) from_stream ( is, fmt, tp )
2) from_stream ( is, fmt. c_str ( ) , tp )
3) from_stream ( is, fmt, tp, std:: addressof ( abbrev ) )
4) from_stream ( is, fmt. c_str ( ) , tp, std:: addressof ( abbrev ) )
5) from_stream ( is, fmt, tp,
static_cast < std:: basic_string < CharT, Traits, Alloc > * > ( nullptr ) , & offset )
6) from_stream ( is, fmt. c_str ( ) , tp,
static_cast < std:: basic_string < CharT, Traits, Alloc > * > ( nullptr ) , & offset )
7) from_stream ( is, fmt, tp, std:: addressof ( abbrev ) , & offset )
8) from_stream ( is, fmt. c_str ( ) , tp, std:: addressof ( abbrev ) , & offset ) .

表达式 is >> manip 是一个类型为 std:: basic_istream < CharT, Traits > 的左值，其值为 is 。

这些重载仅在对应的 from_stream 表达式格式正确时参与重载决议。

建议实现方案应当使格式字符串的潜在悬垂引用难以被误用，例如通过使返回类型不可移动，并阻止 operator >> 接受返回类型的左值。

目录

参数

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 指定读取的最大字符数。默认宽度为 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 、 - 、 + 、 _ 和 / 。

示例

运行此代码 
#include <chrono>
#include <iostream>
#include <locale>
#include <sstream>
int main()
{
    auto parse = [&](auto str, auto fmt, auto o)
    {
        std::istringstream is{str};
        is.imbue(std::locale("en_US.utf-8"));
        is >> std::chrono::parse(fmt, o);
        is.fail() ? std::cout << "Parse failed!\n" : std::cout << o << '\n';
    };
    parse("01:02:03", "%H:%M:%S", std::chrono::hours{});
    parse("01:02:03", "%H:%M:%S", std::chrono::minutes{});
    parse("01:02:03", "%H:%M:%S", std::chrono::seconds{});
}

可能的输出： 

1h
62min
3723s

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

缺陷报告 适用范围 发布时行为 正确行为
LWG 3554 C++20 缺少针对纯空终止字符类型序列的重载版本 已添加

参见

(C++20)
根据指定格式从流中解析 sys_time
(函数模板)
(C++20)
根据指定格式从流中解析 utc_time
(函数模板)
(C++20)
根据指定格式从流中解析 tai_time
(函数模板)
(C++20)
根据指定格式从流中解析 gps_time
(函数模板)
(C++20)
根据指定格式从流中解析 file_time
(函数模板)
(C++20)
根据指定格式从流中解析 local_time
(函数模板)
(C++20)
根据指定格式从流中解析 year
(函数模板)
(C++20)
根据指定格式从流中解析 month
(函数模板)
(C++20)
根据指定格式从流中解析 day
(函数模板)
(C++20)
根据指定格式从流中解析 weekday
(函数模板)
(C++20)
根据指定格式从流中解析 month_day
(函数模板)
(C++20)
根据指定格式从流中解析 year_month
(函数模板)
(C++20)
根据指定格式从流中解析 year_month_day
(函数模板)
(C++11)
解析指定格式的日期/时间值
(函数模板)