std::chrono...ock::to_sys(3)

✨ NAME ✨

std::chrono::utc_clock::to_sys — literally std::chrono::utc_clock::to_sys, that's the whole name, no cap. We're in the C++ Standard Libary manual, bestie, and this page is the main character 💅

🌸 Synopsis 🌸

          template< class Duration >

          static std::chrono::sys_time<std::common_type_t<Duration,
       (since C++20)
          std::chrono::seconds>>

              to_sys( const std::chrono::utc_time<Duration>& t );

Okay so to_sys converts a utc_time t to a sys_time representing the same point in time — if possible 👀. It's giving "same exact moment, different clock system."

Now the leap-second plot twist: if t represents a time point during a leap second insertion, the last representable value of sys_time prior to the insertion of the leap second is returned. In all other cases, utc_clock::from_sys(utc_clock::to_sys(t)) == t. periodt ✨

💖 Return value 💖

A sys_time representing the same point in time as t — or, if t represents a time point during a leap second insertion, the last representable value prior to the insertion of the leap second. That's the whole return vibe, no cap 🫶

🦋 See also 🦋

• from_sys — converts sys_time to utc_time; it's [static] (public static member function).
• clock_cast — converts time points of one clock to another; (C++20) (function template).

that's the tea from http://cppreference.com, version/date 2024.06.10, page label std::chrono...ock::to_sys(3). bye bestie, go convert some clocks 💖🦋✨