As seasoned Pine Script developers, we often need to define specific timeframes for our indicators and strategies. TradingView provides various input options, and understanding how to effectively use time inputs is crucial for building robust and accurate trading tools. Time inputs allow users to specify the start and end times for calculations, visualizations, or strategy execution, offering unparalleled flexibility.
Understanding the Basics of Input Types in Pine Script
Pine Script offers diverse input types, including integers, floats, booleans, strings, and crucially, time. The input.time() function allows users to define a specific time via the indicator’s settings. This time can then be used within the script to trigger events or calculations. Understanding the syntax and capabilities of input.time() is fundamental.
Why Use Time Inputs for ‘Today’ in TradingView?
Specifying the start of the current trading day as a dynamic time input offers several advantages. It allows for calculations tied to the daily open, high, low, close (OHLC), volume-weighted average price (VWAP), or any other daily-specific metric. This provides traders with the ability to analyze intraday price action relative to the current day’s context. Furthermore, dynamic time inputs ensure that the script automatically adjusts to the current date, eliminating the need for manual updates.
Implementing ‘Today’ as a Dynamic Time Input
Achieving a dynamic ‘Today’ time input requires a workaround, as input.time() is designed for static time selection. The built-in functionality doesn’t directly offer a today keyword.
Challenges of Directly Using ‘Today’ in Time Inputs
Pine Script doesn’t have a direct built-in way to represent ‘today’ directly within an input.time() call. The standard approach is to capture the timestamp for the beginning of the day dynamically using Pine Script functions and then use that value for calculations.
Using timestamp() Function to Define the Start of ‘Today’
The timestamp() function is key to defining the start of ‘today’. We can construct a timestamp representing midnight of the current day. This timestamp then becomes the starting point for our calculations. The general form is:
//@version=5
indicator("Today's Start Time", overlay=true)
// Get the current year, month, and day
year = year(timestamp)
month = month(timestamp)
day = dayofmonth(timestamp)
// Create a timestamp for the start of the current day (midnight)
today_start_timestamp = timestamp(year, month, day, 0, 0)
plot(today_start_timestamp != 0 ? high : na, title="Today Start Time")
Converting the Current Date to a Usable Time Value
We now have the timestamp representing the start of ‘today’. This timestamp can be compared with the current chart’s time to trigger calculations or plot elements that are relevant to the current day’s trading session. Remember that Pine Script timestamps are in milliseconds since epoch (January 1, 1970, 00:00:00 UTC).
Practical Examples of Using ‘Today’ Time Inputs
Here are practical examples of how to use the ‘today’ time input.
Highlighting Trading Sessions for the Current Day
We can use the start time of today to highlight the current day’s trading session. The following code highlights the background of the chart from the beginning of the day:
//@version=5
indicator("Highlight Today's Session", overlay=true)
year = year(timestamp)
month = month(timestamp)
day = dayofmonth(timestamp)
today_start_timestamp = timestamp(year, month, day, 0, 0)
// Determine if the current bar is within today's session
is_today_session = time >= today_start_timestamp
// Apply a background color if it's today's session
bgcolor(is_today_session ? color.new(color.blue, 90) : na)
Calculating Daily Open, High, Low, Close (OHLC) Programmatically
The following code calculates the OHLC values for the current day. We use the var keyword to initialize the variables and update them only when a new day starts.
//@version=5
indicator("Daily OHLC", overlay=true)
year = year(timestamp)
month = month(timestamp)
day = dayofmonth(timestamp)
today_start_timestamp = timestamp(year, month, day, 0, 0)
var float dailyOpen = na
var float dailyHigh = na
var float dailyLow = na
var float dailyClose = na
if time >= today_start_timestamp
if time == today_start_timestamp
dailyOpen := close
dailyHigh := close
dailyLow := close
else
dailyHigh := math.max(dailyHigh, close)
dailyLow := math.min(dailyLow, close)
dailyClose := close
plot(dailyOpen, color=color.green, title="Daily Open")
plot(dailyHigh, color=color.blue, title="Daily High")
plot(dailyLow, color=color.red, title="Daily Low")
plot(dailyClose, color=color.purple, title="Daily Close")
Setting Alerts Based on Time of Day
Time-based alerts can be created to trigger at specific times of the day. This is useful for strategies that execute based on daily patterns or events.
//@version=5
indicator("Time Based Alert", overlay=true)
year = year(timestamp)
month = month(timestamp)
day = dayofmonth(timestamp)
today_start_timestamp = timestamp(year, month, day, 9, 30) // 9:30 AM
if time == today_start_timestamp
alert("Alert triggered at 9:30 AM", alert.freq_once_per_bar)
plot(close)
Advanced Techniques and Considerations
Beyond the basics, there are advanced techniques to consider for robust time-based scripts.
Accounting for Time Zone Differences
TradingView charts display time in the exchange’s timezone. When using timestamp(), ensure that your calculations account for any necessary timezone conversions to align with the exchange’s hours.
Optimization Tips for Performance
Calculating timestamps repeatedly can impact performance. Cache the calculated timestamp using var variables and update them only when the date changes. This minimizes redundant calculations.
Handling Edge Cases and Potential Errors
Be aware of edge cases such as delayed data feeds or extended trading hours. Implement error handling to gracefully manage these situations and avoid unexpected script behavior.
Conclusion
Recap of Using Time Inputs for ‘Today’
Effectively using time inputs to represent ‘today’ in Pine Script enhances the precision and relevance of trading indicators and strategies. By dynamically capturing the start of the current trading day, we can create scripts that adapt to daily market conditions and provide valuable insights.
Further Exploration and Learning Resources
- TradingView Pine Script documentation: TradingView Pine Script Reference Manual
- Pine Script community forums: TradingView Forums