Magic_Game/core/base/time.h

// Copyright (c) 2016-2018 Easy2D - Nomango
// 
// 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.

#pragma once
#include "macros.h"
#include <chrono>

namespace easy2d
{
	namespace time
	{
		// ʱ<><CAB1><EFBFBD><EFBFBD>
		//
		// Usage:
		//     ʱ<><CAB1><EFBFBD>α<EFBFBD>ʾ<EFBFBD><CABE>:
		//         5 <20><>: time::Second * 5
		//         1.5 Сʱ: time::Hour * 1.5
		//         3 Сʱ 45 <20><> 15 <20><>: time::Hour * 3 + time::Minute * 45 + time::Second * 15
		//     ʱ<><CAB1><EFBFBD>θ<EFBFBD>ʽ<EFBFBD><CABD>: auto d = time::ParseDuration(L"1h35m");  // 1Сʱ35<33><35><EFBFBD><EFBFBD>
		// 
		class Duration
		{
		public:
			Duration();

			explicit Duration(
				int milliseconds
			);

			// ת<><D7AA>Ϊ<EFBFBD><CEAA><EFBFBD><EFBFBD>
			int Milliseconds() const;

			// ת<><D7AA>Ϊ<EFBFBD><CEAA>
			float Seconds() const;

			// ת<><D7AA>Ϊ<EFBFBD><CEAA><EFBFBD><EFBFBD>
			float Minutes() const;

			// ת<><D7AA>ΪСʱ
			float Hours() const;

			bool operator== (const Duration &) const;
			bool operator!= (const Duration &) const;
			bool operator> (const Duration &) const;
			bool operator>= (const Duration &) const;
			bool operator< (const Duration &) const;
			bool operator<= (const Duration &) const;

			Duration operator + (const Duration &) const;
			Duration operator - (const Duration &) const;
			Duration operator - () const;
			Duration operator * (int) const;
			Duration operator * (float) const;
			Duration operator * (double) const;
			Duration operator / (int) const;
			Duration operator / (float) const;
			Duration operator / (double) const;

			Duration& operator += (const Duration &);
			Duration& operator -= (const Duration &);
			Duration& operator *= (int);
			Duration& operator *= (float);
			Duration& operator *= (double);
			Duration& operator /= (int);
			Duration& operator /= (float);
			Duration& operator /= (double);

			friend Duration operator* (int, const Duration &);
			friend Duration operator* (float, const Duration &);
			friend Duration operator* (double, const Duration &);
			friend Duration operator/ (int, const Duration &);
			friend Duration operator/ (float, const Duration &);
			friend Duration operator/ (double, const Duration &);

		private:
			int milliseconds_;
		};

		extern const Duration Millisecond;	// <20><><EFBFBD><EFBFBD>
		extern const Duration Second;		// <20><>
		extern const Duration Minute;		// <20><><EFBFBD><EFBFBD>
		extern const Duration Hour;			// Сʱ


		// ʱ<><CAB1>
		//
		// Usage:
		//     <20><>ȡ<EFBFBD><C8A1>ǰʱ<C7B0><CAB1>: Time now = time::Now();
		//     ʱ<><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>:
		//         <20><>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD>, <20>õ<EFBFBD>һ<EFBFBD><D2BB> Duration <20><><EFBFBD><EFBFBD>, <20><><EFBFBD><EFBFBD>:
		//         Time t1 = time::Now();
		//         ...  // <20><>Щʲô
		//         Time t2 = time::Now();
		//         auto duration = t2 - t1;
		//         <20><>ȡ<EFBFBD><C8A1>ʱ<EFBFBD><CAB1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ĺ<EFBFBD><C4BA><EFBFBD><EFBFBD><EFBFBD>:
		//         int ms = duration.Milliseconds();
		// 
		class TimePoint
		{
		public:
			TimePoint();

			explicit TimePoint(
				std::chrono::steady_clock::time_point
			);

			TimePoint(
				const TimePoint& other
			);

			TimePoint(
				TimePoint&& other
			);

			// <20><>ȡʱ<C8A1><CAB1><EFBFBD><EFBFBD>
			time_t GetTimeStamp() const;

			// <20>Ƿ<EFBFBD><C7B7><EFBFBD><EFBFBD><EFBFBD>ʱ
			bool IsZero() const;

			TimePoint operator + (const Duration &) const;
			TimePoint operator - (const Duration &) const;

			TimePoint& operator += (const Duration &);
			TimePoint& operator -= (const Duration &);

			Duration operator - (const TimePoint &) const;

			TimePoint& operator = (const TimePoint &) E2D_NOEXCEPT;
			TimePoint& operator = (TimePoint &&) E2D_NOEXCEPT;

		private:
			std::chrono::steady_clock::time_point time_;
		};

		// <20><>ȡ<EFBFBD><C8A1>ǰʱ<C7B0><CAB1>
		TimePoint Now();

		// ʱ<><CAB1><EFBFBD>θ<EFBFBD>ʽ<EFBFBD><CABD>
		// ʱ<><CAB1><EFBFBD><EFBFBD><EFBFBD>ַ<EFBFBD><D6B7><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>з<EFBFBD><D0B7>ŵĸ<C5B5><C4B8><EFBFBD><EFBFBD><EFBFBD>, <20><><EFBFBD>Ҵ<EFBFBD><D2B4><EFBFBD>ʱ<EFBFBD>䵥λ<E4B5A5><CEBB>׺
		// <20><><EFBFBD><EFBFBD>: "300ms", "-1.5h", "2h45m"
		// <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʱ<EFBFBD>䵥λ<E4B5A5><CEBB> "ms", "s", "m", "h"
		Duration ParseDuration(const std::wstring& parse_str);
	}
}