383 라인
20 KiB
MQL5
 | //+------------------------------------------------------------------+
| ||
//| RangeSession.mqh |
| |||
//| Copyright 2025, Leo. |
| |||
//| https://www.mql5.com/es/users/nique_372/news |
| |||
//+------------------------------------------------------------------+
| |||
#property copyright "Copyright 2025, Leo."
| |||
#property link "https://www.mql5.com/es/users/nique_372/news"
| |||
#property strict
| |||
| |||
#ifndef ICTLIBRARY_CONCEPTS_SESION_RANGE_SESSION_MQH
| |||
#define ICTLIBRARY_CONCEPTS_SESION_RANGE_SESSION_MQH
| |||
#include "..\\Base.mqh"
| |||
| |||
| |||
| |||
//+------------------------------------------------------------------+
| |||
//| |
| |||
//+------------------------------------------------------------------+
| |||
//FLUJO DE TRABAJO:
| |||
// La clase CRangeSession consta unicamente de una funcoin para esto OnTicktEvent, ahi se ejectua toda la logica
| |||
/*
| |||
| |||
Ejemplo con sesion 10-14
| |||
start_hour = 10
| |||
start_minute = 0
| |||
end_hour = 14
| |||
end_minute = 0
| |||
| |||
══════════╪══════════════════════════════════════════╪═══════════════════════════════════════
| |||
TIEMPO │ EXTERNO (API Pública) │ INTERNO (Eventos Automáticos)
| |||
══════════╪══════════════════════════════════════════╪═══════════════════════════════════════
| |||
│ │
| |||
09:59 │ IsInitSession() → false │
| |||
│ IsEndSession() → false │ OnOutOfSession() 🔄
| |||
│ EnSesion() → false │
| |||
│ │
| |||
──────────┼──────────────────────────────────────────┼───────────────────────────────────────
| |||
│ │
| |||
10:00 ⚡ │ IsInitSession() → true ⭐ │ OnInitSession() ✅
| |||
│ IsEndSession() → false │ └─ Inicialización de sesión
| |||
│ EnSesion() → true ✅ │ OnSession() ✅
| |||
│ │ └─ Primera actualización
| |||
│ │
| |||
──────────┼──────────────────────────────────────────┼───────────────────────────────────────
| |||
│ │
| |||
10:01 │ IsInitSession() → false │ OnSession() ✅
| |||
│ IsEndSession() → false │ └─ Actualización continua
| |||
│ EnSesion() → true ✅ │
| |||
│ │
| |||
──────────┼──────────────────────────────────────────┼───────────────────────────────────────
| |||
│ │
| |||
... │ IsInitSession() → false │ OnSession() 🔄
| |||
│ IsEndSession() → false │ └─ Actualización continua
| |||
│ EnSesion() → true ✅ │
| |||
│ │
| |||
──────────┼──────────────────────────────────────────┼───────────────────────────────────────
| |||
│ │
| |||
13:58 │ IsInitSession() → false │ OnSession() ✅
| |||
│ IsEndSession() → false │ └─ Actualización continua
| |||
│ EnSesion() → true ✅ │
| |||
│ │
| |||
──────────┼──────────────────────────────────────────┼───────────────────────────────────────
| |||
│ │
| |||
13:59 │ IsInitSession() → false │ OnSession() ✅
| |||
│ IsEndSession() → false │ └─ Última actualización directa
| |||
│ EnSesion() → true ✅ │
| |||
│ │
| |||
──────────┼──────────────────────────────────────────┼───────────────────────────────────────
| |||
│ │
| |||
14:00 ⚡ │ IsInitSession() → false │ OnEndSession() ✅
| |||
│ IsEndSession() → true ⭐ │ ├─ Captura final de datos
| |||
│ EnSesion() → false ❌ │ ├─ Calcula inicio/fin próxima sesión
| |||
│ │ └─ OnSession() (llamada interna)
| |||
│ │ └─ Actualización final max/min
| |||
│ │
| |||
──────────┼──────────────────────────────────────────┼───────────────────────────────────────
| |||
│ │
| |||
14:01 │ IsInitSession() → false │ OnOutOfSession() 🔄
| |||
│ IsEndSession() → false │ └─ Fuera de sesión
| |||
│ EnSesion() → false │
| |||
│ │
| |||
══════════╧══════════════════════════════════════════╧═══════════════════════════════════════
| |||
| |||
LEYENDA:
| |||
⚡ = Momento crítico (inicio/fin de sesión)
| |||
⭐ = Flag temporal (true solo en ese minuto)
| |||
✅ = Ejecución/Estado activo
| |||
❌ = Estado inactivo
| |||
🔄 = Ejecución repetitiva
| |||
| |||
Notas:
| |||
• EnSesion() retorna true durante [10:00, 13:59] (NO incluye 14:00)
| |||
• IsEndSession() retorna true SOLO a las 14:00 (flag temporal)
| |||
• Para incluir el último minuto en lógica: usar EnSesion() || IsEndSession()
| |||
• A las 14:00, OnEndSession() llama internamente a OnSession() para captura final*
| |||
| |||
| |||
*Depende del tipo de sesion (CRangeSession)
| |||
*/
| |||
| |||
//+------------------------------------------------------------------+
| |||
//| |
| |||
//+------------------------------------------------------------------+
| |||
class CRangeSession : public IIctConcept
| |||
{
| |||
private:
| |||
int m_handle;
| |||
| |||
//---
| |||
void Destroy();
| |||
| |||
public:
| |||
CRangeSession();
| |||
~CRangeSession();
| |||
| |||
//---
| |||
bool Create(string symbol_, ENUM_TIMEFRAMES timeframe_, long chart_id_, int subwin_, bool show_concept_, bool forzar_lunes_viernes_
| |||
, int start_hour_, int start_minute_, int end_hour_, int end_minute_, string session_name_);
| |||
| |||
//---
| |||
inline void SetGrapichStyles(ENUM_LINE_STYLE rect_style_, color clr_rect_, int widht_rect_, bool fill_rect_);
| |||
inline void Set(int widht_lines_, ENUM_LINE_STYLE style_lines_, color clr_lines_max, color clr_line_min, color clr_text,
| |||
ENUM_TYPE_DRAW_SESSION_TEXT type_text_, ENUM_TYPE_DRAW_RANGE_SESSION type_draw);
| |||
| |||
//---
| |||
inline bool ShowAll() override final;
| |||
inline bool HideAll() override final;
| |||
inline bool DeleteAll() override final;
| |||
inline void SetFlagMostrarObjetos(bool mostrar) override final;
| |||
inline void ForzeToActulizeCurrentTick() override final;
| |||
inline bool IsNewBarConcept() override final { return ICTRangeSession_IsNewBarConcept(m_handle); }
| |||
| |||
//---
| |||
inline double GetMaxSession(); //Obtiene el maximo de la sesion
| |||
inline double GetMinSession(); //Obtiene el minimo de la sesion
| |||
inline double GetRangeSession(); //Obtiene la altura de la session (maximo - minimo) en distanica NO en puntos
| |||
inline datetime GetInitTimeSessionCurrNext(); //Obtiene el inicio de la sesion (Actual si se llama durante la sesion, y siguiente si se llama depues de la sesion)
| |||
inline datetime GetEndTimeSessionCurrNext(); //Obtiene el fin de la sesion (Actual si se llama durante la sesion, y siguiente si se llama depues de la sesion)
| |||
inline datetime GetInitTimeSessionPrev(); //Obtiene el inicio de la sesion previa
| |||
inline datetime GetEndTimeSessionPrev(); //Obtiene el final de la sesino previa
| |||
inline int GetDuracionSessionSegundos(); //Obtiene la durancion en segundos de la sesion
| |||
inline int GetDuracionSessionMinutos(); //Obtiene la durancion en minutos de la sesion
| |||
inline bool IsInitSession(); //Devuelve true, si ha comenzado la sesion (ESTA FUNCION UNICAMENTE DEVUELVE TRUE UNA SOLA VEZ, AL INICIO DE LA SESION, LUEGO FALSE)
| |||
inline bool IsEndSession(); //Devuelve true, si ha finalizado la sesion (ESTA FUNCION UNICAMENTE DEVUELVE TRUE UNA SOLA VEZ, AL FIN DE LA SESION, LUEGO FALSE)
| |||
inline bool EnSesion(); //Comprueba si estamos en la sesion, true, o de lo contrario false
| |||
inline void OnNewBarM1(); //Ejecuta la logica principal
| |||
inline string GetSessionName(); //Obtiene el nombre de la sesion
| |||
inline int8_t GetSessionInfo(datetime init_day, SessionInfo &out, string _symbol); // Obtinee la infomacion de una sesion pasada o futura
| |||
inline uint8_t CurrState() { return ICTRangeSession_CurrState(m_handle); }
| |||
| |||
//---
| |||
inline void AddLogFlags(const uint8_t flags) override final { ICTRangeSession_AddLogFlags(m_handle, flags); CLoggerBase::AddLogFlags(flags); }
| |||
void RemoveLogFlags(const uint8_t flags) override final { ICTRangeSession_RemoveLogFlags(m_handle, flags); CLoggerBase::RemoveLogFlags(flags); }
| |||
| |||
//---
| |||
inline int Handle() const override final { return m_handle; }
| |||
inline string Symbol() const override final { return ICTRangeSession_Simbolo(m_handle); }
| |||
inline ENUM_TIMEFRAMES Timeframe() const override final { return ICTRangeSession_Timeframe(m_handle); }
| |||
inline long ChartId() const override final { return ICTRangeSession_ChartId(m_handle); }
| |||
inline int Subwin() const override final { return ICTRangeSession_Subwin(m_handle); }
| |||
inline bool InitialStateObj() const override final { return ICTRangeSession_GetInittialStateObj(m_handle); }
| |||
| |||
inline uint8_t ModifyFlags() const override final { return ICTRangeSession_ModifyFlags(m_handle); }
| |||
inline bool GetStateObj() const override final { return ICTRangeSession_GetStateObj(m_handle); }
| |||
inline void Summary() const override final { ICTRangeSession_Summary(m_handle); }
| |||
inline void ChangeChart(long new_chart_id, int new_subwin) override final { ICTRangeSession_ChangeChart(m_handle, new_chart_id, new_subwin); }
| |||
| |||
};
| |||
| |||
//+------------------------------------------------------------------+
| |||
//| |
| |||
//+------------------------------------------------------------------+
| |||
CRangeSession::CRangeSession()
| |||
: m_handle(INVALID_HANDLE)
| |||
{
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
CRangeSession::~CRangeSession()
| |||
{
| |||
Destroy();
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
//| |
| |||
//+------------------------------------------------------------------+
| |||
//- forzar_lunes_vierens_ : Le indica a la clase que la clase solo trabajara de lunes a viernes. (Normalente en crypto es de L -D, por lo que en ese caso si este parametro es false
| |||
//- La clase trabajra de L - D, de lo contrario solo de L - V)
| |||
| |||
//+------------------------------------------------------------------+
| |||
//| |
| |||
//+------------------------------------------------------------------+
| |||
bool CRangeSession::Create(string symbol_, ENUM_TIMEFRAMES timeframe_, long chart_id_, int subwin_, bool show_concept_, bool forzar_lunes_viernes_
| |||
, int start_hour_, int start_minute_, int end_hour_, int end_minute_, string session_name_)
| |||
{
| |||
if(m_handle != INVALID_HANDLE)
| |||
Destroy();
| |||
| |||
//---
| |||
m_handle = ICTRangeSession_Create(symbol_, timeframe_, chart_id_, subwin_, show_concept_, forzar_lunes_viernes_, start_hour_, start_minute_, end_hour_, end_minute_, session_name_);
| |||
| |||
//---
| |||
if(m_handle >= 0)
| |||
{
| |||
return true;
| |||
}
| |||
else
| |||
{
| |||
LogError("No se pudo crear un m_handle para CRangeSession", FUNCION_ACTUAL);
| |||
Remover();
| |||
}
| |||
| |||
//---
| |||
return false;
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
//| |
| |||
//+------------------------------------------------------------------+
| |||
inline void CRangeSession::SetGrapichStyles(ENUM_LINE_STYLE rect_style_, color clr_rect_, int widht_rect_, bool fill_rect_)
| |||
{
| |||
ICTRangeSession_SetGrapichStyles(m_handle, rect_style_, clr_rect_, widht_rect_, fill_rect_);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline void CRangeSession::Set(int widht_lines_, ENUM_LINE_STYLE style_lines_, color clr_lines_max, color clr_line_min, color clr_text,
| |||
ENUM_TYPE_DRAW_SESSION_TEXT type_text_, ENUM_TYPE_DRAW_RANGE_SESSION type_draw)
| |||
{
| |||
ICTRangeSession_Set(m_handle, widht_lines_, style_lines_, clr_lines_max, clr_line_min, clr_text, type_text_, type_draw);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline bool CRangeSession::ShowAll()
| |||
{
| |||
return ICTRangeSession_ShowAll(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline bool CRangeSession::HideAll()
| |||
{
| |||
return ICTRangeSession_HideAll(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline bool CRangeSession::DeleteAll()
| |||
{
| |||
return ICTRangeSession_DeleteAll(m_handle);
| |||
}
| |||
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline void CRangeSession::SetFlagMostrarObjetos(bool mostrar)
| |||
{
| |||
ICTRangeSession_SetFlagMostrarObjetos(m_handle, mostrar);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline void CRangeSession::ForzeToActulizeCurrentTick()
| |||
{
| |||
ICTRangeSession_ForzeToActulizeCurrentTick(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline double CRangeSession::GetMaxSession()
| |||
{
| |||
return ICTRangeSession_GetMaxSession(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline double CRangeSession::GetMinSession()
| |||
{
| |||
return ICTRangeSession_GetMinSession(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline double CRangeSession::GetRangeSession()
| |||
{
| |||
return ICTRangeSession_GetRangeSession(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline datetime CRangeSession::GetInitTimeSessionCurrNext()
| |||
{
| |||
return ICTRangeSession_GetInitTimeSessionCurrNext(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline datetime CRangeSession::GetEndTimeSessionCurrNext()
| |||
{
| |||
return ICTRangeSession_GetEndTimeSessionCurrNext(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline datetime CRangeSession::GetInitTimeSessionPrev()
| |||
{
| |||
return ICTRangeSession_GetInitTimeSessionPrev(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline datetime CRangeSession::GetEndTimeSessionPrev()
| |||
{
| |||
return ICTRangeSession_GetEndTimeSessionPrev(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline int CRangeSession::GetDuracionSessionSegundos()
| |||
{
| |||
return ICTRangeSession_GetDuracionSessionSegundos(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline int CRangeSession::GetDuracionSessionMinutos()
| |||
{
| |||
return ICTRangeSession_GetDuracionSessionMinutos(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline bool CRangeSession::IsInitSession()
| |||
{
| |||
return ICTRangeSession_IsInitSession(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline bool CRangeSession::IsEndSession()
| |||
{
| |||
return ICTRangeSession_IsEndSession(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline bool CRangeSession::EnSesion()
| |||
{
| |||
return ICTRangeSession_EnSesion(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline void CRangeSession::OnNewBarM1()
| |||
{
| |||
ICTRangeSession_OnNewBarM1(m_handle);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
inline string CRangeSession::GetSessionName()
| |||
{
| |||
return ICTRangeSession_GetSessionName(m_handle);
| |||
}
| |||
| |||
//+----------------------------------------------------------------------------------+
| |||
//| Obtiene la informacion de una sesion en base al inicio del dia |
| |||
//| Inputs: |
| |||
//| - init_day: Dia en el cual se quiere obtener informacion (fecha - datetime) |
| |||
//| - out: Estructura del tipo SessionInfo, en la cual se obtendra la informacion |
| |||
//| - _symbol: Simbolo en la cual se buscara el maximo y minimo de la sesion |
| |||
//| Outputs: |
| |||
//| - int8_t: La funcion tiene pensado estos valores de retorno |
| |||
//| SESSION_INFO_SUCCESS - 0: Se obtuvo el maximo, minimo, fecha de inicio y fin |
| |||
//| de la sesino exitosamente. |
| |||
//| SESSION_INFO_PARTIAL - 1: Se obtuvo parcialmente la info del maximo y minimo |
| |||
//| , pero si se obtuvo informacion del inicio y fin |
| |||
//| de la sesion |
| |||
//| |
| |||
//| SESSION_INFO_FUTURE - 2: Solo se obtuvo el inicio y fin de la sesion |
| |||
//| Dado que la seison es futura. |
| |||
//| |
| |||
//+----------------------------------------------------------------------------------+
| |||
inline int8_t CRangeSession::GetSessionInfo(datetime init_day, SessionInfo &out, string _symbol)
| |||
{
| |||
return ICTRangeSession_GetSessionInfo(m_handle, init_day, out, _symbol);
| |||
}
| |||
| |||
//+------------------------------------------------------------------+
| |||
void CRangeSession::Destroy()
| |||
{
| |||
if(m_handle != INVALID_HANDLE)
| |||
{
| |||
ICTRangeSession_Delete(m_handle);
| |||
m_handle = INVALID_HANDLE;
| |||
}
| |||
}
| |||
| |||
| |||
| |||
#endif // ICTLIBRARY_CONCEPTS_SESION_RANGE_SESSION_MQH
| |||
//+------------------------------------------------------------------+
|