Namespaces
Variants
Views
Actions

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

From cppreference.com
< cpp‎ | chrono‎ | month
 
 
Utilities library
General utilities
Relational operators (deprecated in C++20)
Integer comparison functions
(C++20)(C++20)(C++20)
(C++20)
Swap and type operations
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
Common vocabulary types
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)

Elementary string conversions
(C++17)
(C++17)
Stacktrace
 
Date and time utilities
(C++11)
(C++11)
Time of day
(C++20)



(C++20)(C++20)(C++20)(C++20)
Clocks
(C++20)
                                             
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
Calendars
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
Time zones
(C++20)
(C++20)
(C++20)
(C++20)
C-style date and time
 
 
constexpr std::chrono::month operator+(const std::chrono::month& m,
                                       const std::chrono::months& ms) noexcept;
(1) (since C++20)
constexpr std::chrono::month operator+(const std::chrono::months& ms,
                                       const std::chrono::month& m) noexcept;
(2) (since C++20)
constexpr std::chrono::month operator-(const std::chrono::month& m,
                                       const std::chrono::months& ms) noexcept;
(3) (since C++20)
constexpr std::chrono::months operator-(const std::chrono::month& m1,
                                        const std::chrono::month& m2) noexcept;
(4) (since C++20)
1-2) Adds ms.count() months to m. The month value held in the result is computed by first evaluating static_cast<long long>(unsigned(m)) + (ms.count() - 1), reducing it modulo 12 to an integer in the range [0, 11], and then adding 1.
3) Subtracts ms.count() months from m and returns the result. Equivalent to return m + -ms;
4) If m1.ok() and m2.ok() are both true, returns a std::chrono::months value m such that m.count() is in the range [0, 11] and m2 + m == m1. Otherwise the returned value is unspecified.

Contents

[edit] Return value

1-3) A std::chrono::month holding a month value calculated as described above.
4) A std::chrono::months representing the distance between m1 and m2.

[edit] Notes

As long as the computation doesn't overflow, (1-3) always return a valid month even if m.ok() is false.

The result of subtracting two month values is a duration of type std::chrono::months. That duration unit represents the length of the average Gregorian month, and the resulting duration bears no relationship to the number of days in the particular months represented by the operands. For example, std::chrono::seconds(std::chrono::April - std::chrono::March) is not the number of seconds in March (2678400s), but 2629746s (30.436875 days).

[edit] Example

#include <iostream>
#include <chrono>
 
int main()
{
 
    std::chrono::month m {6};
 
    m = m + std::chrono::months(2);
    if (m == std::chrono::month(8)) {
        std::cout << "Months added correctly" << "\n";
    } else {
        std::cout << "Months not added correctly" << "\n";
    }
 
    m = m - std::chrono::months(3);
    if (m == std::chrono::month(5)) {
        std::cout << "Months subtracted correctly" << "\n";
    } else {
        std::cout << "Months not subtracted correctly" << "\n";
    }
 
    std::chrono::months ms = std::chrono::month(8) - std::chrono::month(6);
    if (ms == std::chrono::months(2)) {
        std::cout << "Months subtracted correctly" << "\n";
    } else {
        std::cout << "Months not subtracted correctly" << "\n";
    }
 
}

Output:

Months added correctly
Months subtracted correctly
Months subtracted correctly

[edit] See also

increments or decrements the month
(public member function) [edit]
adds or subtracts a number of months
(public member function) [edit]