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

来自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)

 
 
 
constexpr std::chrono::year_month_weekday

    operator+( const std::chrono::year_month_weekday& ymwd,

               const std::chrono::months& dm ) noexcept;
(1) (C++20 起)
constexpr std::chrono::year_month_weekday

    operator+( const std::chrono::months& dm,

               const std::chrono::year_month_weekday& ymwd ) noexcept;
(2) (C++20 起)
constexpr std::chrono::year_month_weekday

    operator+( const std::chrono::year_month_weekday& ymwd,

               const std::chrono::years& dy ) noexcept;
(3) (C++20 起)
constexpr std::chrono::year_month_weekday

    operator+( const std::chrono::years& dy,

               const std::chrono::year_month_weekday& ymwd ) noexcept;
(4) (C++20 起)
constexpr std::chrono::year_month_weekday

    operator-( const std::chrono::year_month_weekday& ymwd,

               const std::chrono::months& dm ) noexcept;
(5) (C++20 起)
constexpr std::chrono::year_month_weekday

    operator-( const std::chrono::year_month_weekday& ymwd,

               const std::chrono::years& dy ) noexcept;
(6) (C++20 起)
1,2)dm.count() 月加到 ymwd 所表示的日期。结果与 std::chrono::year_month(ymwd.year(), ymwd.month()) + dm 拥有相同的 year()month(),并与 ymwd 拥有相同的 weekday()index()
3,4)dy.count() 年加到 ymwd 所表示的日期。结果等价于 std::chrono::year_month_weekday(ymwd.year() + dy, ymwd.month(), ymwd.weekday_indexed())
5)ymwd 所表示的日期减去 dm.count() 月。等价于 ymwd + -dm
6)ymwd 所表示的日期减去 dy.count() 年。等价于 ymwd + -dy

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

注解

即使 ymwd.ok()true,若 ymwd.index()5 则生成的 year_month_weekday 仍可能不表示合法日期。

示例

#include <cassert>
#include <chrono>
#include <iostream>
 
int main()
{
    auto ymwdi{1/std::chrono::Wednesday[1]/2021};
    std::cout << ymwdi << '\n';
 
    ymwdi = std::chrono::years(5) + ymwdi;
    // 2026 年一月的第一个星期三
    std::cout << ymwdi << '\n';
    assert(static_cast<std::chrono::year_month_day>(ymwdi) ==
           std::chrono::January/7/2026);
 
    ymwdi = ymwdi - std::chrono::months(6);
    // 2025 年七月的第一个星期三
    std::cout << ymwdi << '\n';
    assert(static_cast<std::chrono::year_month_day>(ymwdi) ==
           std::chrono::July/2/2025);
}

输出:

2021/Jan/Wed[1]
2026/Jan/Wed[1]
2025/Jul/Wed[1]