std::chrono::operator<<(std::chrono::year)

From cppreference.com
< cpp‎ | chrono‎ | year
C++
Date and time library
Time point
(C++11)
(C++20)
Duration
(C++11)
Clocks
(C++11)
(C++11)
(C++20)
(C++20)
(C++20)
(C++11)
(C++20)
(C++20)
(C++20)
Time of day
(C++20)(C++20)
(C++20)(C++20)
(C++20)

Calendar
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
Time zone
(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)
C-style date and time
std::chrono::year
Defined in header <chrono>
template < class CharT, class Traits >

std::basic_ostream<CharT, Traits>&

    operator<< ( std::basic_ostream <CharT, Traits> & os, const std::chrono::year & y ) ;
(since C++20)

Forms a std::basic_string<CharT> s consisting of the year value stored in y formatted as a decimal number, left-padded with ​0​ to four digits if the result would otherwise be less than four digits. Then, if !y.ok(), append " is not a valid year" to the formatted string. Inserts that string into os

Equivalent to

return os << (y.ok ( ) ?
std::format (STATICALLY_WIDEN<CharT> ( "{:%Y}" ), y) :
std::format (STATICALLY_WIDEN<CharT> ( "{:%Y} is not a valid year" ), y) ) ;

where STATICALLY_WIDEN<CharT>("...") is "..." if CharT is char, and L"..." if CharT is wchar_t

Return value

os

Example

Run this code
#include <chrono>
#include <iostream>
 
int main()
{
    constexpr std::chrono::year y1{2020}, y2{-020}, y3{98304};
    std::cout << y1 << '\n'
              << y2 << '\n'
              << y3 << '\n';
}

Possible output: 

2020
-0016
-32768 is not a valid year

See also

(C++20)
 stores formatted representation of the arguments in a new string
(function template)
(C++20)
 formatting support for year
(class template specialization)
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/chrono/year/operator_ltlt&oldid=161685