WorkingTime.h

#pragma once
//-----------------------------------------------------------------------
// <copyright file="WorkingTime.cs" company="Aspose Pty Ltd">
//   Copyright (c) 2002-2024 Aspose Pty Ltd. All Rights Reserved.
// </copyright>
//-----------------------------------------------------------------------
 
#include <system/object.h>
#include <system/date_time.h>
#include <cstdint>
 
#include "aspose.tasks.cpp/aspose_tasks_api_defs.h"
 
namespace Aspose
{
namespace Tasks
{
class Calendar;
class CalendarDatesCalculator;
class CalendarWorkingTimesForwardEnumerator;
class DatesCalculator;
namespace Recalculation
{
class TimephasedDataCalculationUtil;
} // namespace Recalculation
class TimephasedDataMaker;
class WorkingTimeCollection;
} // namespace Tasks
} // namespace Aspose
namespace System
{
class String;
class TimeSpan;
} // namespace System
 
namespace Aspose {
 
namespace Tasks {
 
/// <summary>
/// Represents a working time during a weekday.
/// </summary>
class ASPOSE_TASKS_SHARED_CLASS WorkingTime : public System::Object
{
    typedef WorkingTime ThisType;
    typedef System::Object BaseType;
    
    typedef ::System::BaseTypesInfo<BaseType> ThisTypeBaseTypesInfo;
    ASPOSE_TASKS_SHARED_RTTI_INFO_DECL();
    
    friend class Aspose::Tasks::Calendar;
    friend class Aspose::Tasks::CalendarWorkingTimesForwardEnumerator;
    friend class Aspose::Tasks::Recalculation::TimephasedDataCalculationUtil;
    friend class Aspose::Tasks::CalendarDatesCalculator;
    friend class Aspose::Tasks::DatesCalculator;
    friend class Aspose::Tasks::TimephasedDataMaker;
    friend class Aspose::Tasks::WorkingTimeCollection;
    
public:
 
    /// <summary>
    /// Gets the beginning of a working time.
    /// </summary>
    ASPOSE_TASKS_SHARED_API System::DateTime get_From() const;
    /// <summary>
    /// Gets the end of a working time.
    /// </summary>
    ASPOSE_TASKS_SHARED_API System::DateTime get_To() const;
    
    /// <summary>
    /// Initializes a new instance of the <see cref="WorkingTime"></see> class with a interval with the specified start and finish times.
    /// </summary>
    /// <param name="fromTime">interval start time</param>
    /// <param name="toTime">interval end time</param>
    ASPOSE_TASKS_SHARED_API WorkingTime(System::DateTime fromTime, System::DateTime toTime);
    /// <summary>
    /// Initializes a new instance of the <see cref="WorkingTime"></see> class with an interval item with the specified start and finish times.
    /// </summary>
    /// <param name="fromTime">Interval's start time represented by <see cref="TimeSpan"></see> struct.</param>
    /// <param name="toTime">Interval's end time represented by <see cref="TimeSpan"></see> struct.</param>
    /// <example>
    /// The overload of WorkingTime ctor can be used to initialize interval's start and end using TimeSpans:
    /// <code>
    /// [C#]
    /// var wt = new WorkingTime(new TimeSpan(9, 0, 0), new TimeSpan(18, 0, 0));
    /// </code>
    /// </example>
    /// <exception cref="ArgumentException">When toTime less than of equal to toTime argument
    /// or when interval between fromTime and toTime is greater than 24 hours.</exception>
    ASPOSE_TASKS_SHARED_API WorkingTime(System::TimeSpan fromTime, System::TimeSpan toTime);
    /// <summary>
    /// Initializes a new instance of the <see cref="WorkingTime"></see> class with an interval item with the specified start and finish times.
    /// </summary>
    /// <param name="fromHours">Interval's start time represented by whole number of hours (0-24).</param>
    /// <param name="toHours">Interval's end time represented by whole number of hours (0-24).</param>
    /// <example>
    /// The overload of WorkingTime ctor can be used to initialize interval's start and end using whole hours:
    /// <code>
    /// [C#]
    /// var wt = new WorkingTime(9, 13);
    /// </code>
    /// </example>
    /// <exception cref="ArgumentException">When toTime less than of equal to toTime argument
    /// or when interval between fromTime and toTime is greater than 24 hours.</exception>
    ASPOSE_TASKS_SHARED_API WorkingTime(int32_t fromHours, int32_t toHours);
    
    /// <summary>
    /// Checks that the objects are equal.
    /// </summary>
    /// <param name="obj">Second object to compare.</param>
    /// <returns>True if the objects are equal, false otherwise.</returns>
    ASPOSE_TASKS_SHARED_API bool Equals(System::SharedPtr<System::Object> obj) override;
    /// <summary>
    /// Returns a hash code value for the instance of the <see cref="WorkingTime"></see> class.
    /// </summary>
    /// <returns>returns a hash code value for this object.</returns>
    ASPOSE_TASKS_SHARED_API int32_t GetHashCode() const override;
    
protected:
 
    ASPOSE_TASKS_SHARED_API bool get_Is24Hour();
    ASPOSE_TASKS_SHARED_API System::TimeSpan get_Work();
    
    static ASPOSE_TASKS_SHARED_API System::SharedPtr<WorkingTime> CreatePrecise(System::TimeSpan from, System::TimeSpan to);
    ASPOSE_TASKS_SHARED_API System::DateTime GetFromDate(System::DateTime date);
    ASPOSE_TASKS_SHARED_API System::DateTime GetToDate(System::DateTime date);
    ASPOSE_TASKS_SHARED_API System::TimeSpan GetIntersectSpan(const System::SharedPtr<WorkingTime>& other);
    ASPOSE_TASKS_SHARED_API System::TimeSpan GetIntersectSpan(System::DateTime fromNormalized, System::DateTime toNormalized);
    ASPOSE_TASKS_SHARED_API bool Contains(System::DateTime dateTime);
    ASPOSE_TASKS_SHARED_API bool ContainsNormalized(System::DateTime dateNormalized);
    ASPOSE_TASKS_SHARED_API bool IsEndTime(System::DateTime dateTime);
    #ifdef ASPOSE_GET_SHARED_MEMBERS
    ASPOSE_TASKS_SHARED_API void GetSharedMembers(System::Object::shared_members_type& result) const override;
    #endif
    
    
private:
 
    static const int64_t TicksPerMinute;
    static const int64_t HalfTicksPerMinute;
    
    static System::DateTime& EndOfDay();
    
    System::DateTime fromTime;
    System::DateTime toTime;
    
    System::String get_DebuggerDisplay();
    
    static System::DateTime AlignTime(System::DateTime dt);
    void SetFromTime(System::DateTime value);
    void SetToTime(System::DateTime value);
    
};
 
} // namespace Tasks
} // namespace Aspose