命名空间
变体
操作

std::chrono::parse

来自 cppreference.com
< cpp‎ | chrono
 
 
实用程序库
语言支持
类型支持 (基本类型,RTTI)
库特性测试宏 (C++20)
动态内存管理
程序实用程序
协程支持 (C++20)
可变参数函数
调试支持
(C++26)
三元比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用实用程序
日期和时间
函数对象
格式库 (C++20)
(C++11)
关系运算符 (C++20 中已弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
通用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
基本字符串转换
(C++17)
(C++17)

 
 
定义在头文件 <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 偏移量的持续时间

[编辑] 格式字符串

格式字符串由零个或多个转换说明符和普通字符组成。每个普通字符(不包括空白字符和终止空字符)与输入流中的一个相同字符匹配,或者如果流中的下一个字符不匹配,则导致函数失败。

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

每个未修改的转换说明符以一个%字符开头,后跟一个字符,该字符确定说明符的行为。一些转换说明符具有修改形式,其中在%字符之后插入一个EO修饰符字符。一些转换说明符具有修改形式,其中在%字符之后插入一个作为正十进制整数给出的宽度参数(在下面显示为N)。每个转换说明符都会根据下表将匹配的字符解释为日期和时间类型的部分。

格式字符串中以%开头的字符序列,但不匹配下面列出的转换说明符之一,将被解释为普通字符。

如果from_stream未能解析格式字符串指定的所有内容,或者解析的信息不足以指定完整的結果,或者解析显示出矛盾的信息,则会调用is.setstate(std::ios_base::failbit)

以下是可用的转换说明符:

转换
说明符
解释
%% 匹配一个文字%字符。
%n 匹配一个空白字符。
%t 匹配零个或一个空白字符。
年份
%C
%NC
%EC
将世纪解析为十进制数。宽度N指定要读取的最大字符数。默认宽度为 2。允许前导零,但不强制要求。

修改后的命令%EC解释了该语言环境对世纪的替代表示形式。

%y
%Ny
%Ey
%Oy
解析年份的最后两位十进制数字。如果世纪没有被另行指定(例如,使用 %C),则范围 [69, 99] 内的值被假定为指 1969 年到 1999 年,范围 [00, 68] 内的值被假定为指 2000 年到 2068 年。宽度N指定要读取的最大字符数。默认宽度为 2。允许前导零,但不强制要求。

修改后的命令%Ey%Oy解释了该语言环境的替代表示形式。

%Y
%NY
%EY
将年份解析为十进制数。宽度N指定要读取的最大字符数。默认宽度为 4。允许前导零,但不强制要求。

修改后的命令%EY解释了该语言环境的替代表示形式。

月份
%b
%B
%h
解析该语言环境的完整或缩写不区分大小写的月份名称。
%m
%Nm
%Om
将月份解析为十进制数(1 月为1)。宽度N指定要读取的最大字符数。默认宽度为 2。允许前导零,但不强制要求。

修改后的命令%Om解释了该语言环境的替代表示形式。

日期
%d
%Nd
%Od
%e
%Ne
%Oe
将日期解析为十进制数。宽度N指定要读取的最大字符数。默认宽度为 2。允许前导零,但不强制要求。

修改后的命令%Od%Oe解释了该语言环境的替代表示形式。

星期几
%a
%A
解析该语言环境的完整或缩写不区分大小写的星期名称。
%u
%Nu
将 ISO 星期几解析为十进制数 (1-7),其中星期一是1。宽度N指定要读取的最大字符数。默认宽度为 1。允许前导零,但不强制要求。
%w
%Nw
%Ow
将星期几解析为十进制数 (0-6),其中星期日为0。宽度N指定要读取的最大字符数。默认宽度为 1。允许前导零,但不强制要求。

修改后的命令%Ow解释了该语言环境的替代表示形式。

ISO 8601 基于星期的年份

在 ISO 8601 中,星期从星期一开始,并且每年的第一周必须满足以下要求:

  • 包含 1 月 4 日
  • 包含该年的第一个星期四
%g
%Ng
解析 ISO 8601 基于星期的年份的最后两位十进制数字。宽度N指定要读取的最大字符数。默认宽度为 2。允许前导零,但不强制要求。
%G
%NG
将 ISO 8601 基于星期的年份解析为十进制数。宽度N指定要读取的最大字符数。默认宽度为 4。允许前导零,但不强制要求。
%V
%NV
将 ISO 8601 年份的星期数解析为十进制数。宽度N指定要读取的最大字符数。默认宽度为 2。允许前导零,但不强制要求。
一周中的星期/日期
%j
%Nj
将一年中的日期解析为十进制数(1 月 1 日为1)。宽度N指定要读取的最大字符数。默认宽度为 3。允许前导零,但不强制要求。
%U
%NU
%OU
将一年中的星期数解析为十进制数。该年的第一个星期日是第 01 周的第一天。该年之前的天数属于第 00 周。宽度N指定要读取的最大字符数。默认宽度为 2。允许前导零,但不强制要求。

修改后的命令%OU解释了该语言环境的替代表示形式。

%W
%NW
%OW
将一年中的星期数解析为十进制数。该年的第一个星期一是第 01 周的第一天。该年之前的天数属于第 00 周。宽度N指定要读取的最大字符数。默认宽度为 2。允许前导零,但不强制要求。

修改后的命令%OW解释了该语言环境的替代表示形式。

日期
%D 相当于"%m/%d/%y"
%F
%NF
相当于"%Y-%m-%d"。如果指定了宽度,则它只应用于%Y
%x
%Ex
解析该语言环境的日期表示形式。

修改后的命令%Ex解释了该语言环境的替代日期表示形式。

一天中的时间
%H
%NH
%OH
将小时(24 小时制)解析为十进制数。宽度N指定要读取的最大字符数。默认宽度为 2。允许前导零,但不强制要求。

修改后的命令%OH解释了该语言环境的替代表示形式。

%I
%NI
%OI
将小时(12 小时制)解析为十进制数。宽度N指定要读取的最大字符数。默认宽度为 2。允许前导零,但不强制要求。

修改后的命令%OI解释了该语言环境的替代表示形式。

%M
%NM
%OM
将分钟解析为十进制数。宽度N指定要读取的最大字符数。默认宽度为 2。允许前导零,但不强制要求。

修改后的命令%OM解释了该语言环境的替代表示形式。

%S
%NS
%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 解析时区缩写或名称,它被视为仅包含字符AZaz09-+_/的最长字符序列。

[编辑] 示例

[编辑] 缺陷报告

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

DR 应用于 发布的行为 正确行为
LWG 3554 C++20 缺少针对普通以空字符结尾的字符类型序列的重载 已添加

[编辑] 另请参阅

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