std::chrono::operator+, std::chrono::operator- (std::chrono::year_month_day)

来自cppreference.com
 
 
工具库
语言支持
类型支持(基本类型、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> 定义
constexpr std::chrono::year_month_day operator+( const std::chrono::year_month_day& ymd,

                                                 const std::chrono::months& dm

                                               ) noexcept;
(C++20 起)
constexpr std::chrono::year_month_day operator+( const std::chrono::months& dm,

                                                 const std::chrono::year_month_day& ymd

                                               ) noexcept;
(C++20 起)
constexpr std::chrono::year_month_day operator+( const std::chrono::year_month_day& ymd,

                                                 const std::chrono::years& dy

                                               ) noexcept;
(C++20 起)
constexpr std::chrono::year_month_day operator+( const std::chrono::years& dy,

                                                 const std::chrono::year_month_day& ymd

                                               ) noexcept;
(C++20 起)
constexpr std::chrono::year_month_day operator-( const std::chrono::year_month_day& ymd,

                                                 const std::chrono::months& dm

                                               ) noexcept;
(C++20 起)
constexpr std::chrono::year_month_day operator-( const std::chrono::year_month_day& ymd,

                                                 const std::chrono::years& dy

                                               ) noexcept;
(C++20 起)
1,2)dm.count() 月加到 ymd 所表示的日期。结果与 ymd 拥有相同的 day(),且与 std::chrono::year_month(ymd.year(), ymd.month()) + dm 拥有相同的 year()month()
3,4)dy.count() 年加到 ymd 所表示的日期。结果等价于 std::chrono::year_month_day(ymd.year() + dy, ymd.month(), ymd.day()
5)ymd 所表示的日期减去 dm.count() 月。等价于 ymd + -dm
6)ymd 所表示的日期减去 dy.count() 年。等价于 ymd + -dy

对于能转换到 std::chrono::yearsstd::chrono::months 两者的时长,若调用本会有歧义则偏好 years 重载 (3,4,6)

注解

即使 ymd.ok() 为 true ,若 ymd.day() 为 29 、 30 或 31 ,则产生的 year_month_day 可能不表示合法日期。

示例

#include <chrono>
#include <iostream>
 
int main()
{
    std::cout << std::boolalpha;
 
    auto ymd{std::chrono::day(1)/std::chrono::July/2021};
 
    ymd = ymd + std::chrono::months(4);
    std::cout << (ymd.month() == std::chrono::November) << ' '
              << (ymd.year() == std::chrono::year(2021)) << ' ';
 
    ymd = ymd - std::chrono::years(10);
    std::cout << (ymd.month() == std::chrono::month(11)) << ' '
              << (ymd.year() == std::chrono::year(2011)) << '\n';
}

输出:

true true true true