Represents time in segments (hour, minute, etc.). More...

#include <time.hpp>

Public Member Functions
constexpr Result< void, TimeValidationError >	try_validate () const
	Tries to validate.

constexpr	operator NanoSeconds () const

constexpr	operator DayFraction () const

constexpr auto	operator<=> (const Segments &o) const

bool	operator== (const Segments &o) const

bool	operator!= (const Segments &o) const

bool	operator< (const Segments &o) const

bool	operator> (const Segments &o) const

bool	operator<= (const Segments &o) const

bool	operator>= (const Segments &o) const

constexpr f64	to_fraction_unchecked () const
	Converts to a day fraction without checking if it's valid.

Public Attributes
u8	hour = 0

u8	minute = 0

u8	second = 0

u32	nano = 0

Detailed Description

Represents time in segments (hour, minute, etc.).

Definition at line 45 of file calendars/mtcore_calendars/time.hpp.

Member Function Documentation

◆ operator DayFraction()

mtcore::calendars::Segments::operator DayFraction ( ) const

explicitnodiscardconstexpr

Definition at line 190 of file calendars/mtcore_calendars/time.hpp.

                                                 {
    const auto nanos = static_cast<NanoSeconds>(*this);
    return static_cast<DayFraction>(nanos);
  }

◆ operator NanoSeconds()

mtcore::calendars::Segments::operator NanoSeconds ( ) const

explicitnodiscardconstexpr

Definition at line 180 of file calendars/mtcore_calendars/time.hpp.

                                                 {
    ensure(try_validate().is_success());
    const auto hours   = static_cast<u64>(this->hour);
    const auto minutes = 60 * hours + static_cast<u64>(this->minute);
    const auto seconds = 60 * minutes + static_cast<u64>(this->second);
    const auto nano    = seconds * NANOS_PER_SECOND + static_cast<u64>(this->nano);
    const auto res     = NanoSeconds{.nano = nano};
    ensure(res.try_validate().is_success());
    return res;
  }

Here is the call graph for this function:

◆ operator!=()

bool mtcore::calendars::Segments::operator!= ( const Segments & o ) const

inlinenodiscard

Definition at line 92 of file calendars/mtcore_calendars/time.hpp.

92{ return (*this <=> o) != std::strong_ordering::equal; }

◆ operator<()

bool mtcore::calendars::Segments::operator< ( const Segments & o ) const

inlinenodiscard

Definition at line 93 of file calendars/mtcore_calendars/time.hpp.

93{ return (*this <=> o) == std::strong_ordering::less; }

◆ operator<=()

bool mtcore::calendars::Segments::operator<= ( const Segments & o ) const

inlinenodiscard

Definition at line 95 of file calendars/mtcore_calendars/time.hpp.

                                                           {
      const auto cmp = (*this <=> o);
      return cmp == std::strong_ordering::equal || cmp == std::strong_ordering::less;
    }

◆ operator<=>()

auto mtcore::calendars::Segments::operator<=> ( const Segments & o ) const

inlinenodiscardconstexpr

Definition at line 75 of file calendars/mtcore_calendars/time.hpp.

                                                                      {
      if (hour != o.hour) {
        return hour <=> o.hour;
      }
      if (minute != o.minute) {
        return minute <=> o.minute;
      }
      if (second != o.second) {
        return second <=> o.second;
      }
      if (nano != o.nano) {
        return nano <=> o.nano;
      }
      return std::strong_ordering::equal;
    }

◆ operator==()

bool mtcore::calendars::Segments::operator== ( const Segments & o ) const

inlinenodiscard

Definition at line 91 of file calendars/mtcore_calendars/time.hpp.

91{ return (*this <=> o) == std::strong_ordering::equal; }

◆ operator>()

bool mtcore::calendars::Segments::operator> ( const Segments & o ) const

inlinenodiscard

Definition at line 94 of file calendars/mtcore_calendars/time.hpp.

94{ return (*this <=> o) == std::strong_ordering::greater; }

◆ operator>=()

bool mtcore::calendars::Segments::operator>= ( const Segments & o ) const

inlinenodiscard

Definition at line 99 of file calendars/mtcore_calendars/time.hpp.

                                                           {
      const auto cmp = (*this <=> o);
      return cmp == std::strong_ordering::equal || cmp == std::strong_ordering::greater;
    }

◆ to_fraction_unchecked()

f64 mtcore::calendars::Segments::to_fraction_unchecked ( ) const

nodiscardconstexpr

Converts to a day fraction without checking if it's valid.

Prefer casting to a DayFraction. Used with internal conversion methods.

Definition at line 195 of file calendars/mtcore_calendars/time.hpp.

                                                      {
    const auto hours     = static_cast<u64>(this->hour);
    const auto minutes   = 60 * hours + static_cast<u64>(this->minute);
    const auto seconds   = 60 * minutes + static_cast<u64>(this->second);
    const auto nano      = seconds * NANOS_PER_SECOND + static_cast<u64>(this->nano);
    const auto nanoFloat = static_cast<f80>(nano);
    const auto frac      = nanoFloat / static_cast<f80>(NANOS_PER_DAY);
    return static_cast<f64>(frac);
  }

◆ try_validate()

Result< void, TimeValidationError > mtcore::calendars::Segments::try_validate ( ) const

inlinenodiscardconstexpr

Tries to validate.

Will return validation error describing what's wrong if invalid.

Definition at line 52 of file calendars/mtcore_calendars/time.hpp.

                                                                                   {
      if (hour >= 24) {
        return error(TimeValidationError::INVALID_HOUR);
      }
 
      if (minute >= 60) {
        return error(TimeValidationError::INVALID_MINUTE);
      }
 
      if (second >= 60) {
        return error(TimeValidationError::INVALID_SECOND);
      }
 
      if (nano >= NANOS_PER_SECOND) {
        return error(TimeValidationError::INVALID_NANOSECOND);
      }
 
      return success();
    }