Available translations

Time Range

foundations.png
time-range.png
The time range parameter determines the period of time on which the trading session is run.
Content
The parameter offers precise control over the duration, starting and ending points of the session. Several options are available, and there are differences in how backtesting and the rest of the types of trading sessions function in this regard.
Configuring
Time Range Configuration
On Backtesting Sessions
 {
"initialDatetime": "2019-09-01T00:00:00.000Z",
"finalDatetime": "2019-09-25T00:00:00.000Z"
}
  • initialDatetime is the datetime the session starts at.
  • finalDatetime is the datetime the session finishes at. If you don't set a finalDatetime* at the level of the testing session or the trading system, then the session runs for one year.
On Paper Trading, Forward Testing and Live Trading Sessions
 {
"initialDatetime": "2019-09-01T00:00:00.000Z",
"finalDatetime": "2019-09-25T00:00:00.000Z",
"allowStartingFromThePast": false
}
By default, paper trading, forward testing and live trading sessions start at the datetime the session is run, that is, the present time. Such a behavior is in accordance with the most common use case, by which a user starting a new live trading session usually wishes the session to start at that moment.
However, users have requested to be allowed to start live sessions in the past. Such a feature may be useful, for example, to take an opportunity that was just missed for whatever reason, including technical ones.
  • initialDatetime, in combination with the allowStartingFromThePast parameter, is a hack to allow a live session to start from a date in the past. If there is a valid initialDatetime and allowStartingFromThePast is true, then the live session effectively starts from the specified date in the past. If allowStartingFromThePast is false the initialDatetime is ignored and the session starts from the present time.
  • allowStartingFromThePast may be true or false.
Initial Values
These are the Initial Values for Time Range configuration: 
 {
    "initialDatetime": "2020-09-01",
    "finalDatetime": "2020-09-02"
}
Examples
This is a list of properties featured by the Time Range configuration. Expanding a property shows sample values for the property extracted from the current Workspace.
Time Range Menu
The Time Range node has the following Node Menu items:
The Configure menu item has the following properties:
  • action: Configure
  • label: Configure
  • iconPathOn: configuration
  • iconPathOff: configuration
  • actionFunction: uiObject.configEditor.activate
The Delete menu item has the following properties:
  • action: Delete UI Object
  • actionProject: Visual-Scripting
  • askConfirmation: true
  • confirmationLabel: Confirm to Delete
  • label: Delete
  • iconPathOn: delete-entity
  • iconPathOff: delete-entity
  • actionFunction: payload.executeAction
Time Range Attaching Rules
The following are the Node Attaching Rules that govern the attachment of Time Range with other nodes:
Compatible Types: