OPEN-SOURCE SCRIPT
Updated

GranDoc - Week, Day, Month, and Session Separator5

1 268
Indicator Name: GranDoc's - Week, Day, Month, and Session Separator
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.



Release Notes
Indicator Name: GranDoc's - Week, Day, Month, and Session Separator
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.
Release Notes
Quick Update on Grandoc's MTF SeparatorsHey folks, just a fresh tweak to the "GranDoc - Week, Day, Month, and Session Separator" indicator—now bumped up to Grandoc's MTF Separators with some solid enhancements. (MTF? That's "Multi-Timeframe," so you can slap higher-timeframe lines like weekly or monthly right on your intraday charts for that extra layer of context.) Built on Jonpaul Nnamdi Opara's original by grandoc, this version keeps the core week/day/month/session vibes but amps it up with up to four custom MTF separators, better Frankfurt handling, and those handy 30-min closing range boxes to spotlight end-of-session highs/lows. All while staying super customizable for colors, styles, and times—perfect for keeping your EURUSD futures chart clean and actionable.© grandoc
Created: October 12, 2025
Last Modified: October 12, 2025
Version: 1.4 (Quick wins: Full MTF flexibility for four timeframes; Frankfurt gets its own toggles for opens/closes/ranges; added subtle range boxes for volatility wrap-ups)What's New in This UpdateMTF Superpower: Beyond basic week/day/month, now pick any four timeframes (seconds to years) for vertical lines that extend everywhere—think daily dots crossing a Tokyo open for confluences.
Session Polish: Same sessions (Sydney 22:00–07:00, Tokyo 00:00–09:00, Frankfurt 07:00–16:00, London 08:00–17:00, NY 13:00–22:00 UTC), but with per-session toggles for opens (dotted default) and closes (solid). Frankfurt's got independent controls now.
Closing Ranges: Fresh feature—toggle on 30-min boxes (e.g., London 16:30–17:00) shading highs/lows with 80% fade. Great for quick S/R spots without the noise.
Smarter Setup: Dedicated session timezone (exchange default); MTF reference toggle (Session for market opens or Day for midnight); lookback limits to keep things snappy.

Rest stays true: No background mode or labels (kept it line-focused for precision), but tooltips in settings make it dummy-proof.Quick Setup RefreshPaste into Pine Editor, hit "Add to Chart."
Settings groups: Separators for MTF toggles, Style for looks, Preferences for reference/timezone, then session-specific tabs for opens/closes/ranges/times/colors/lookback.
Pro move: On 15m EURUSD futures, enable D1/W1 MTF + NY ranges—watch those closes light up liquidity traps.

Why Bother Updating?Nails forex/stocks/futures/crypto day trades by blending MTF pivots with session flow—e.g., weekly reset + Frankfurt open for EU bias. Less clutter, more edge. Works best intraday; auto-hides on dailies+.Heads-UpUTC defaults—tweak for DST/rollovers.
Ranges off by default to save perf; enable what you need.
Time-based only—no Renko fun.

Open-source as always—grab it, tweak it, credit grandoc. Drop a comment if you want more!

Disclaimer

The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.