[time.cal.year.nonmembers] (original) (raw)

30 Time library [time]

30.8 The civil calendar [time.cal]

30.8.5 Class year [time.cal.year]

30.8.5.3 Non-member functions [time.cal.year.nonmembers]

constexpr bool operator==(const year& x, const year& y) noexcept;

Returns: int{x} == int{y}.

constexpr strong_ordering operator<=>(const year& x, const year& y) noexcept;

Returns: int{x} <=> int{y}.

constexpr year operator+(const year& x, const years& y) noexcept;

Returns: year{int{x} + static_cast<int>(y.count())}.

constexpr year operator+(const years& x, const year& y) noexcept;

constexpr year operator-(const year& x, const years& y) noexcept;

constexpr years operator-(const year& x, const year& y) noexcept;

Returns: years{int{x} - int{y}}.

template<class charT, class traits> basic_ostream<charT, traits>& operator<<(basic_ostream<charT, traits>& os, const year& y);

Effects: Equivalent to:return os << (y.ok() ? format(_STATICALLY-WIDEN_<charT>("{:%Y}"), y) : format(STATICALLY-WIDEN<charT>("{:%Y} is not a valid year"), y));

template<class charT, class traits, class Alloc = allocator<charT>> basic_istream<charT, traits>& from_stream(basic_istream<charT, traits>& is, const charT* fmt, year& y, basic_string<charT, traits, Alloc>* abbrev = nullptr, minutes* offset = nullptr);

Effects: Attempts to parse the input stream isinto the year y using the format flags given in the NTCTS fmtas specified in [time.parse].

If the parse fails to decode a valid year,is.setstate(ios_base​::​failbit) is called andy is not modified.

If %Z is used and successfully parsed, that value will be assigned to *abbrev if abbrev is non-null.

If %z (or a modified variant) is used and successfully parsed, that value will be assigned to *offset if offset is non-null.

constexpr chrono::year operator""y(unsigned long long y) noexcept;

Returns: year{static_cast<int>(y)}.