Custom Time Alert with Vertical Line

📌 Detailed Explanation of the Custom Time Alert with Vertical Line in Pine Script v5
This script is a time-based alert system designed for TradingView. It allows traders to set a specific hour and minute for alerts and provides visual indicators on the chart, including a marker when the alert triggers and a vertical line at the alert time.

🔹 Main Features
Custom Alert Time → Users can specify the exact hour and minute for an alert.
Time Zone Offset Support → Users can manually adjust their local UTC offset to ensure alerts trigger at the correct time.
Real-Time Alert Condition → When the market reaches the set time, an alert notification is triggered.
Chart Visualization → A red marker appears when the alert is activated, and a blue vertical line is drawn at the alert time.
Automated Calculation → The script adjusts the alert time based on the user’s time zone settings.
🛠️ How It Works
User Input for Alert Time

The script allows users to enter their desired alert hour (0-23) and minute (0-59).
This ensures the alert triggers at the exact specified time.
Time Zone Offset Handling

Users enter their UTC offset (e.g., New York is -5, Tokyo is +9).
This ensures alerts work correctly regardless of the user’s location.
Time Calculation

The script adjusts the TradingView time by adding the time zone offset in milliseconds.
This converts the UTC-based TradingView time into the user’s local time.
Checking for a Time Match

The script constantly checks if the current hour and minute match the user-defined alert time.
If they match, the script activates an alert.
Triggering Alerts

The script uses TradingView’s alertcondition() function to create an alert.
When the time matches, TradingView sends a notification (e.g., pop-up, sound, or mobile alert).
Chart Markers for Visual Alerts

A red marker is displayed on the chart when the alert triggers.
A blue vertical line is drawn at the exact alert time.
📌 Example Use Cases
📈 1. Forex Traders Monitoring Market Opens
A forex trader who trades the London session wants an alert when the market opens at 8:00 AM UTC.

The trader sets:
Alert Hour = 8
Alert Minute = 0
Time Zone Offset = 0 (for UTC)
When the market reaches 8:00 AM UTC, the script triggers an alert.
📈 2. Stock Market Open Alerts
A trader in New York (EST) wants an alert at 9:30 AM Eastern Time (New York Stock Exchange open).

New York’s UTC offset is -5.
The trader sets:
Alert Hour = 9
Alert Minute = 30
Time Zone Offset = -5
The script ensures the alert triggers at 9:30 AM EST.
📈 3. Crypto Trader Watching a Specific Time
A crypto trader wants an alert for a specific strategy at 3:00 PM in Tokyo (UTC+9).

Tokyo’s UTC offset is +9.
The trader sets:
Alert Hour = 15
Alert Minute = 0
Time Zone Offset = +9
The script ensures the alert triggers exactly at 3:00 PM Tokyo time.