Namespaces
Variants
Views
Actions

std::chrono::year_month_day_last

From cppreference.com
< cpp‎ | chrono
 
 
Utilities library
Language support
Type support (basic types, RTTI)
Library feature-test macros (C++20)
Dynamic memory management
Program utilities
Coroutine support (C++20)
Variadic functions
Debugging support
(C++26)
Three-way comparison
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
General utilities
Date and time
Function objects
Formatting library (C++20)
(C++11)
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)
(C++23)
Elementary string conversions
(C++17)
(C++17)

 
Date and time utilities
Time point
(C++11)
(C++20)
Duration
(C++11)
Clocks
(C++11)      
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
Time of day
(C++20)(C++20)
(C++20)(C++20)
(C++20)

Calendars
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
year_month_day_last
(C++20)
(C++20)      
(C++20)
(C++20)
(C++20)(C++20)
Time zones
(C++20)
(C++20)
(C++20)
chrono I/O
(C++20)
C-style date and time
 
 
Defined in header <chrono>
class year_month_day_last;
(since C++20)

The class year_month_day_last represents the last day of a specific year and month. It is a field-based time point, with a resolution of std::chrono::days, subject to the limit that it can only represent the last day of a month.

std::chrono::years- and std::chrono::months-oriented arithmetic are supported directly. An implicit conversion to std::chrono::sys_days allows std::chrono::days-oriented arithmetic to be performed efficiently.

year_month_day_last is a TriviallyCopyable StandardLayoutType.

Contents

[edit] Member functions

constructs a year_month_day_last object
(public member function) [edit]
modifies the time point by some number of months or years
(public member function) [edit]
accesses the fields of this object
(public member function) [edit]
converts to a std::chrono::time_point
(public member function) [edit]
checks whether this object represents a valid date
(public member function) [edit]

[edit] Nonmember functions

compares two year_month_day_last values
(function) [edit]
adds or subtracts a year_month_day_last and some number of years or months
(function) [edit]
outputs a year_month_day_last into a stream
(function template) [edit]

[edit] Helper classes

formatting support for year_month_day_last
(class template specialization) [edit]
hash support for std::chrono::year_month_day_last
(class template specialization)

[edit] Example

#include <chrono>
#include <iostream>
 
int main()
{
    const auto ymd = std::chrono::year_month_day
    {
        std::chrono::floor<std::chrono::days>(std::chrono::system_clock::now())
    };
 
    const std::chrono::year_month_day_last ymdl
    {
        ymd.year(), ymd.month() / std::chrono::last
    };
 
    std::cout << "The last day of present month (" << ymdl << ") is: "
              << std::chrono::year_month_day{ymdl}.day() << '\n';
 
    // The 'last' object can be placed wherever it is legal to place a 'day':
    using namespace std::chrono;
    constexpr std::chrono::year_month_day_last
        ymdl1 = 2023y / February / last,
        ymdl2 = last / February / 2023y,
        ymdl3 = February / last / 2023y;
    static_assert(ymdl1 == ymdl2 && ymdl2 == ymdl3);
}

Possible output:

The last day of present month (2023/Aug/last) is: 31

[edit] See also

represents a specific year, month, and day
(class) [edit]