GranDoc - Week, Day, Month, and Session Separator5

Version: Pine Script v5
Author: Jonpaul Nnamdi Opara (GranDoc )
Description
The "GranDoc - Week, Day, Month, and Session Separator" is a highly customizable TradingView indicator designed to enhance chart analysis by visually marking critical time-based transitions. Developed by Jonpaul Nnamdi Opara, this tool plots vertical lines with labels or background highlights to denote the start and end of weeks, days, months, and major trading sessions (Frankfurt, London, NY Morning, NY Afternoon, Sydney, and Tokyo). Traders can tailor colors, line styles, widths, transparency, and session times to align with their strategies and timezones.
Ideal for forex, stocks, futures, and crypto traders, this indicator simplifies the identification of key market periods—such as session openings/closings or new weeks—that often signal increased volatility or trend shifts. It’s optimized for intraday timeframes for session separators but supports all timeframes for week, day, and month markers, making it a versatile addition to any trader’s toolkit.
Features
Week Separators: Marks Monday starts with customizable lines and "Week Start" labels.
Day Separators: Highlights daily openings with lines and "Day Start" labels.
Month Separators: Indicates new months with lines and "Month Start" labels.
Session Separators: Plots lines and labels for major trading sessions’ start and end:
Frankfurt (default: 07:00–15:00 UTC)
London (default: 08:00–16:00 UTC)
NY Morning (default: 13:00–16:00 UTC)
NY Afternoon (default: 16:00–21:00 UTC)
Sydney (default: 22:00–06:00 UTC)
Tokyo (default: 00:00–08:00 UTC)
Timezone Support: Adjusts session times with a UTC offset (±12 hours).
Display Flexibility: Toggle between labeled vertical lines or background highlights.
Customization: Fine-tune colors, line styles (solid, dashed, dotted), widths, and transparency.
Background Mode: Highlights periods with translucent backgrounds for cleaner charts.
[i]Labeled Lines: Each line includes descriptive labels (e.g., "London Open", "Tokyo Closed") when not in background mode.
How to Use
Add to Chart:
Copy the script into TradingView’s Pine Editor.
Click "Add to Chart" to apply the indicator.
Customize Settings:
Open settings via double-click or the "Settings" gear icon.
Timezone Offset: Set your UTC offset (e.g., -5 for EST) to align sessions.
Toggles: Enable/disable week, day, month, or session separators.
Appearance: Adjust colors, line styles, widths, and transparency for each separator.
Session Times: Modify start/end hours and minutes if defaults don’t suit your market.
Background Mode: Enable "Show as Background" for colored backgrounds instead of lines, and tweak "Session Background Transparency."
Labels: Labeled lines (e.g., "Sydney Open") appear automatically unless background mode is active.
Chart Compatibility:
Session separators require intraday timeframes (e.g., 1-minute to 4-hour).
Week, day, and month separators work across all timeframes.
Confirm your chart’s timezone aligns with your analysis.
Analyze:
Use separators to pinpoint session transitions, daily openings, or weekly shifts for trade planning.
Labels make it easy to spot key periods on busy charts.
Pair with indicators like RSI, volume, or support/resistance for deeper insights.
Example Use Cases
Forex Trading: Highlight London and NY session opens/closes for high-liquidity entries.
Day Trading: Reset strategies at daily separators and monitor intraday volatility.
Swing Trading: Use week/month separators to track longer-term trends.
Session Focus: Isolate sessions like Tokyo for regional market analysis.
Chart Clarity: Background mode declutters charts while marking key times.
Notes
Session separators are disabled on daily+ timeframes to prevent clutter.
Verify timezone offset for accurate session alignment.
Background mode suits lower timeframes for readability.
Labels are visible only when background mode is disabled.
Feedback
Share your thoughts or suggestions to make this indicator even better! Reach out via TradingView or connect with the author for insights. Happy trading!
About the Author
Dr. Jonpaul Nnamdi Opara, a PhD graduate from Ehime University, Japan, is a researcher and developer specializing in AI and machine learning. His work on automated landslide mapping and defect detection, published in journals like GEOMATE, showcases his precision-driven approach. With the "GranDoc" indicator, Jonpaul brings intuitive, data-driven clarity to financial markets, reflecting his expertise in creating impactful tools.
Version: Pine Script v5
Author: Dr. Jonpaul Nnamdi Opara (GranDoc )
Description
The "GranDoc - Week, Day, Month, and Session Separator" is a highly customizable TradingView indicator designed to enhance chart analysis by visually marking critical time-based transitions. Developed by Jonpaul Nnamdi Opara, this tool plots vertical lines with labels or background highlights to denote the start and end of weeks, days, months, and major trading sessions (Frankfurt, London, NY Morning, NY Afternoon, Sydney, and Tokyo). Traders can tailor colors, line styles, widths, transparency, and session times to align with their strategies and timezones.
Ideal for forex, stocks, futures, and crypto traders, this indicator simplifies the identification of key market periods—such as session openings/closings or new weeks—that often signal increased volatility or trend shifts. It’s optimized for intraday timeframes for session separators but supports all timeframes for week, day, and month markers, making it a versatile addition to any trader’s toolkit.
Features
Week Separators: Marks Monday starts with customizable lines and "Week Start" labels.
Day Separators: Highlights daily openings with lines and "Day Start" labels.
Month Separators: Indicates new months with lines and "Month Start" labels.
Session Separators: Plots lines and labels for major trading sessions’ start and end:
Frankfurt (default: 07:00–15:00 UTC)
London (default: 08:00–16:00 UTC)
NY Morning (default: 13:00–16:00 UTC)
NY Afternoon (default: 16:00–21:00 UTC)
Sydney (default: 22:00–06:00 UTC)
Tokyo (default: 00:00–08:00 UTC)
Timezone Support: Adjusts session times with a UTC offset (±12 hours).
Display Flexibility: Toggle between labeled vertical lines or background highlights.
Customization: Fine-tune colors, line styles (solid, dashed, dotted), widths, and transparency.
Background Mode: Highlights periods with translucent backgrounds for cleaner charts.
Labeled Lines: Each line includes descriptive labels (e.g., "London Open", "Tokyo Closed") when not in background mode.
How to Use
Add to Chart:
Copy the script into TradingView’s Pine Editor.
Click "Add to Chart" to apply the indicator.
Customize Settings:
Open settings via double-click or the "Settings" gear icon.
Timezone Offset: Set your UTC offset (e.g., -5 for EST) to align sessions.
Toggles: Enable/disable week, day, month, or session separators.
Appearance: Adjust colors, line styles, widths, and transparency for each separator.
Session Times: Modify start/end hours and minutes if defaults don’t suit your market.
Background Mode: Enable "Show as Background" for colored backgrounds instead of lines, and tweak "Session Background Transparency."
Labels: Labeled lines (e.g., "Sydney Open") appear automatically unless background mode is active.
Chart Compatibility:
Session separators require intraday timeframes (e.g., 1-minute to 4-hour).
Week, day, and month separators work across all timeframes.
Confirm your chart’s timezone aligns with your analysis.
Analyze:
Use separators to pinpoint session transitions, daily openings, or weekly shifts for trade planning.
Labels make it easy to spot key periods on busy charts.
Pair with indicators like RSI, volume, or support/resistance for deeper insights.
Example Use Cases
Forex Trading: Highlight London and NY session opens/closes for high-liquidity entries.
Day Trading: Reset strategies at daily separators and monitor intraday volatility.
Swing Trading: Use week/month separators to track longer-term trends.
Session Focus: Isolate sessions like Tokyo for regional market analysis.
Chart Clarity: Background mode declutters charts while marking key times.
Notes
Session separators are disabled on daily+ timeframes to prevent clutter.
Verify timezone offset for accurate session alignment.
Background mode suits lower timeframes for readability.
Labels are visible only when background mode is disabled.
Feedback
Share your thoughts or suggestions to make this indicator even better! Reach out via TradingView or connect with the author for insights. Happy trading!
About the Author
Dr. Jonpaul Nnamdi Opara, a PhD graduate from Ehime University, Japan, is a researcher and developer specializing in AI and machine learning. His work on automated landslide mapping and defect detection, published in journals like GEOMATE, showcases his precision-driven approach. With the "GranDoc" indicator, Jonpaul brings intuitive, data-driven clarity to financial markets, reflecting his expertise in creating impactful tools.
Script open-source
In pieno spirito TradingView, il creatore di questo script lo ha reso open-source, in modo che i trader possano esaminarlo e verificarne la funzionalità. Complimenti all'autore! Sebbene sia possibile utilizzarlo gratuitamente, ricorda che la ripubblicazione del codice è soggetta al nostro Regolamento.
Per un accesso rapido a un grafico, aggiungi questo script ai tuoi preferiti: per saperne di più clicca qui.
Declinazione di responsabilità
Script open-source
In pieno spirito TradingView, il creatore di questo script lo ha reso open-source, in modo che i trader possano esaminarlo e verificarne la funzionalità. Complimenti all'autore! Sebbene sia possibile utilizzarlo gratuitamente, ricorda che la ripubblicazione del codice è soggetta al nostro Regolamento.
Per un accesso rapido a un grafico, aggiungi questo script ai tuoi preferiti: per saperne di più clicca qui.