CIS Session: A Class for Defining Trading Time Intervals
Info
The CIS Session: A Class for Defining Trading Time Intervals is a Library for MetaTrader 5 that this class is designed to help define and manage trading time intervals (sessions) within trading strategies. The class aims to simplify the input of date and time, reduce potential errors, and preserve the ability to optimize time intervals in the strategy tester.
Usage
This tool is typically used for enhancing chart analysis and decision making.
Platform
This Library works exclusively on MetaTrader 5 (both build 600+ and newer versions).
Setup
Place the downloaded file in MQL5/Libraries folder via File ? Open Data Folder in MetaTrader 5.
How to Install and Use CIS Session: A Class for Defining Trading Time Intervals
1. Storage: Place library files in the MQL/Libraries directory to ensure they are accessible to your projects.
2. Implementation: Include the library in your code using the #import directive, ensuring you match the exact function names and parameters.
3. Compilation: Ensure the library is present in the directory before you compile your main EA or script, as the compiler links them during this phase.
4. Management: Keep libraries organized in sub-folders if you manage many custom functions to maintain a clean project structure.
Frequently Asked Questions
Q: What is a library file used for? A: Libraries store reusable code modules, allowing you to centralize common logic used by multiple EAs or indicators.
Q: Is a library executable? A: No, libraries are non-executable files containing functions; they must be imported into an EA, indicator, or script to function.
Q: Can I update a library while the platform is running? A: You should compile your EA or script after updating a library to ensure the latest code changes are integrated.
What this tool does
This class is designed to help define and manage trading time intervals (sessions) within trading strategies.
Typical Use Case
This Library excels in automated trading and technical analysis on MetaTrader 5.
Compatible Platform & Setup
This Library works on MetaTrader 5. Place the file in the MQL5/Libraries folder and restart the terminal.
Description & Settings
Related: simplified order management class for mt4/mt5 - another powerful library for MetaTrader 5 traders.
This class is designed to help define and manage trading time intervals (sessions) within trading strategies.Also recommended: class calc frac - custom bar count for fractal detection - similar library with strong performance on MetaTrader 5.
The class aims to simplify the input of date and time, reduce potential errors, and preserve the ability to optimize time intervals in the strategy tester.
All settings can be quickly modified anywhere within the program.
The class offers several options for setting trading times:
1. Daily Session
Allows trading every day within a specified time interval.
Conditions:
- The session start and end dates are equal to 1970.01.01.
- The session start time is less than the session end time.
2. Night Session
Allows trading through the night, from today until tomorrow, every day.
Conditions:
- The session start and end dates are equal to 1970.01.01.
- The session start time is greater than the session end time.
3. Within a Range of Dates
Allows trading from a specified session start date up to a specified session end date.
Conditions:
- The session start date is less than the session end date.
- Any time within this range is considered.
4. Outside a Range of Dates
Allows trading until the session end date and after the new session start date, when the session start date is after the session end date.
Conditions:
- The session start date is greater than the session end date.
- Any time is considered.
5. Disabling/Enabling Trading on Weekdays
Set 'true' for each weekday to enable trading or 'false' to disable it.
6. All Settings Can Be Changed
Any setting can be modified anywhere in the program, including within init() methods.
This class was created for MetaTrader 5 but also works for MetaTrader 4. The primary difference is that the MetaTrader 4 strategy tester does not support optimization of time intervals in datetime format. This can be addressed by converting datetime to long in the EA input parameters.
You may also like: cgv class for global variables - excellent alternative for library users on MetaTrader 5.
Source Code
#property copyright "robotfx"
#property link "https://robotfx.org"
#property version "1.00"
#include <issession.mqh>
sinput string inpsettings_1 = "---------------------------------------------------------------------------"; // :
input datetime inpbeginsession1 = 0; //
input datetime inpendsession1 = seconds_day-1; //
sinput string inpsettings_2 = "---------------------------------------------------------------------------"; // :
input datetime inpbeginsession2 = 0; //
input datetime inpendsession2 = seconds_day-1; // .......
⚠ Limitations & Risk Warning
- This tool is provided for educational and testing purposes only.
- Past performance does not guarantee future results.
- Trading involves substantial risk of loss. Use on a demo account first.
- Results may vary depending on market conditions, broker, and settings.
- We recommend thorough backtesting and forward testing before using with real funds.