DateTime.hpp

/*
 * DateTime.hpp
 * 
 * Copyright (C) 2019-20 by RStudio, PBC
 *
 * Unless you have received this program directly from RStudio pursuant to the terms of a commercial license agreement
 * with RStudio, then this program is licensed to you under the following terms:
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
 * documentation files (the "Software"), to deal in the Software without restriction, including without limitation the
 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
 * permit persons to whom the Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the
 * Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
 * WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
 * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
 * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 *
 */
 
#ifndef LAUNCHER_PLUGINS_DATE_TIME_HPP
#define LAUNCHER_PLUGINS_DATE_TIME_HPP
 
#include <string>
 
#include <ctime>
#include <PImpl.hpp>
namespace rstudio {
namespace launcher_plugins {
 
class Error;
 
} // namespace launcher_plugins
} // namespace rstudio
namespace rstudio {
namespace launcher_plugins {
namespace system {
 
// Forward Declaration
class DateTime;
 
class TimeDuration final
{
public:
   explicit TimeDuration(
      int64_t in_hours = 0,
      int64_t in_minutes = 0,
      int64_t in_seconds = 0,
      int64_t in_microseconds = 0);
 
   TimeDuration(const TimeDuration& in_other);
 
   TimeDuration(TimeDuration&& in_other) noexcept;
 
   ~TimeDuration() = default;
 
   static TimeDuration Infinity();
 
   static TimeDuration Hours(int64_t in_hours);
 
   static TimeDuration Minutes(int64_t in_minutes);
 
   static TimeDuration Seconds(int64_t in_seconds);
 
   static TimeDuration Microseconds(int64_t in_microseconds);
 
   TimeDuration& operator=(const TimeDuration& in_other);
 
   TimeDuration& operator=(TimeDuration&& in_other) noexcept;
 
   bool operator==(const TimeDuration& in_other) const;
 
 
   bool operator!=(const TimeDuration& in_other) const;
 
   bool operator<(const TimeDuration& in_other) const;
 
   bool operator<=(const TimeDuration& in_other) const;
 
   bool operator>(const TimeDuration& in_other) const;
 
   bool operator>=(const TimeDuration& in_other) const;
 
   bool isInfinity() const;
 
   int64_t getHours() const;
 
   int64_t getMinutes() const;
 
   int64_t getSeconds() const;
 
   int64_t getMicroseconds() const;
 
private:
   // The private implementation of interval time.
   PRIVATE_IMPL(m_impl);
 
   friend class DateTime;
};
 
class DateTime final
{
public:
   DateTime();
 
   DateTime(const DateTime& in_other);
 
   DateTime(DateTime&& in_other) noexcept;
 
   DateTime(std::time_t& in_time) noexcept;
 
   static Error fromString(const std::string& in_timeStr, DateTime& out_dateTime);
 
   static Error fromString(const std::string& in_timeStr, const std::string& in_format, DateTime& out_dateTime);
   DateTime& operator=(const DateTime& in_other);
 
   DateTime& operator=(DateTime&& in_other) noexcept;
 
   TimeDuration operator-(const DateTime& in_other) const;
 
   DateTime operator-(const TimeDuration& in_intervalTime) const;
 
   DateTime& operator-=(const TimeDuration& in_intervalTime);
 
   DateTime operator+(const TimeDuration& in_intervalTime) const;
 
   DateTime& operator+=(const TimeDuration& in_intervalTime);
 
   bool operator==(const DateTime& in_other) const;
 
   bool operator!=(const DateTime& in_other) const;
 
   bool operator<(const DateTime& in_other) const;
 
   bool operator<=(const DateTime& in_other) const;
 
   bool operator>(const DateTime& in_other) const;
 
   bool operator>=(const DateTime& in_other) const;
 
   std::string toString() const;
 
   std::string toString(const char* in_format) const;
 
   std::string toString(const std::string& in_format) const;
 
private:
   // The private implementation of DateTime.
   PRIVATE_IMPL(m_impl);
};
 
} // namespace system
} // namespace launcher_plugins
} // namespace rstudio
 
#endif