time_zone_struct.mqh

Go to the documentation of this file.

//+------------------------------------------------------------------+
//|                                             time_zone_struct.mqh |
//|                           Time Shield - MQL5 Time Zone Structure |
//|                                      Copyright 2025, NewYaroslav |
//|                   https://github.com/NewYaroslav/time-shield-cpp |
//+------------------------------------------------------------------+
#ifndef __TIME_SHIELD_TIME_ZONE_STRUCT_MQH__
#define __TIME_SHIELD_TIME_ZONE_STRUCT_MQH__

 
#property copyright "Copyright 2025, NewYaroslav"
#property link      "https://github.com/NewYaroslav/time-shield-cpp"
#property strict
 
namespace time_shield {

    struct TimeZoneStruct {
       int  hour;        
       int  min;         
       bool is_positive; 
    };

    TimeZoneStruct create_time_zone_struct(
            const int  hour,
            const int  min,
            const bool is_positive = true) {
       TimeZoneStruct result;
       result.hour        = hour;
       result.min         = min;
       result.is_positive = is_positive;
       return result;
    }
 
    //----------------------------------------------------------------------

    TimeZoneStruct to_time_zone_struct(const int offset) {
       int abs_val      = (int)MathAbs(offset);
       int hour         = abs_val / SEC_PER_HOUR;
       int min          = abs_val % SEC_PER_MIN;
       bool is_positive = (offset >= 0);
       return create_time_zone_struct(hour, min, is_positive);
    }

    TimeZoneStruct to_tz(const int offset) {
       return to_time_zone_struct(offset);
    }
 
    //----------------------------------------------------------------------

    string time_zone_struct_to_string(const TimeZoneStruct &tz) {
       string result = tz.is_positive ? "+" : "-";
       if (tz.hour < 10)
          result += "0";
       result += IntegerToString(tz.hour);
       result += ":";
       if (tz.min < 10)
          result += "0";
       result += IntegerToString(tz.min);
       return result;
    }

    string to_string(const TimeZoneStruct &tz) {
       return time_zone_struct_to_string(tz);
    }

    string to_str(const TimeZoneStruct &tz) {
       return time_zone_struct_to_string(tz);
    }
 
    //----------------------------------------------------------------------

    int time_zone_struct_to_offset(const TimeZoneStruct &tz) {
       int sign = tz.is_positive ? 1 : -1;
       return sign * (tz.hour * SEC_PER_HOUR + tz.min * SEC_PER_MIN);
    }

    int tz_to_offset(const TimeZoneStruct &tz) {
       return time_zone_struct_to_offset(tz);
    }

    int to_offset(const TimeZoneStruct &tz) {
       return time_zone_struct_to_offset(tz);
    }
 
}; // namespace time_shield
 
#endif // __TIME_SHIELD_TIME_ZONE_STRUCT_MQH__