This ProBuilder code snippet demonstrates how to access and display historical data from a different timeframe within the current chart’s timeframe. Specifically, it retrieves the date, open time, and close time of a candlestick from the 1-hour timeframe and displays this information in the current timeframe.

timeframe(1 hour, updateonclose) //save the candlestick date, open and close time in variable arrays
$candleDate[barindex]=date
$candleOpenTime[barindex]=OpenTime
$candleCloseTime[barindex]=time
timeframe(default) //get the 10th back 1-hour candlestick info
iindex = max(0,lastset($candleDate)-10)
idate = $candleDate[iindex]
iopen = $candleOpenTime[iindex]
iclose = $candleCloseTime[iindex]
return idate, iopen, iclose

The code snippet above is structured to perform the following steps:

• Set the timeframe to 1 hour: The timeframe(1 hour, updateonclose) function changes the chart’s timeframe to 1 hour for the purpose of data extraction. The updateonclose parameter ensures that the data is updated at the close of each 1-hour candlestick.
• Store historical data in arrays: The date, open time, and close time of each candlestick are stored in respective arrays – $candleDate, $candleOpenTime, and $candleCloseTime. These arrays are indexed by barindex, which represents the current bar’s index in the 1-hour timeframe.
• Switch back to the default timeframe: The timeframe(default) function resets the chart’s timeframe to the default setting, typically the timeframe that the chart was originally set to display.
• Access historical data from the arrays: The code calculates the index for the 10th last candlestick in the 1-hour timeframe using max(0, lastset($candleDate)-10). It then retrieves the date, open time, and close time for this specific candlestick using the calculated index.
• Return the retrieved data: Finally, the date, open time, and close time of the 10th last 1-hour candlestick are returned, making them available for display or further processing in the current timeframe.

This example is useful for traders or analysts who need to compare or analyze data across different timeframes on the same chart.