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

来自cppreference.com
 
C++
 
日期和时间库
时间点
(C++11)
(C++20)  
(C++20)
时长
(C++11)
时钟
(C++11)
(C++11)
(C++20)
(C++20)
(C++20)
(C++11)
(C++20)
(C++20)
(C++20)
当天时刻
(C++20)(C++20)
(C++20)(C++20)
(C++20)
日历
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)  
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
chrono I/O
(C++20)

 
std::chrono::year_month_day
 
在标头 <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::years 与 std::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