Appearance

Personalize your experience

Mode
Accent Color
Direction
Date Range

Date Range

Time measurement

A horizontal bar highlighting a specific time period on the chart. Date ranges mark important calendar windows such as earnings seasons, economic release periods, or historical trading ranges.

Overview

The Date Range tool draws a span across the chart from a start date to an end date. The region is highlighted with a colored and bordered by vertical markers at the start and end. The total duration — in trading days, calendar days, or bars — is displayed directly on the highlighted area. This makes it the horizontal equivalent of the tool: where Price Range measures vertical distance, Date Range measures horizontal distance through time.

Use date range to highlight earnings windows, FOMC blackout periods, historical consolidation zones, or any pattern that matters to your analysis. The tool helps you visualize time in the same way that lines visualize price levels. The colored makes the period stand out at a glance, and the duration label removes the need to count bars or days manually. This time-focused perspective is essential for cycle analysis and understanding how long market phases persist before transitioning.

Date ranges time spans only. For combined time and price measurements that capture both dimensions simultaneously, use the Date+ tool. The Date Range tool is specifically focused on analysis — it helps you think in terms of duration, not just price levels. Many market phenomena are time-dependent (expiration cycles, dressing, tax-loss harvesting), and the Date Range tool makes these temporal patterns visible and measurable.

The tool is especially powerful when used in conjunction with . Together, they provide a complete two-dimensional measurement system: Date Range for time, Price Range for price. This combined approach is the foundation of multi-dimensional market analysis that considers both axes of the chart rather than focusing exclusively on price action.

Anatomy

Earnings windowJan 15Feb 5
A date range marking an earnings window with start and end dates labeled.
Measurement bound Price level Target / profit Price action Current price / midpoint Date span Grid rung / entry side
Start date
The time coordinate where the range begins.
End date
The time coordinate where the range ends.
Highlight fill
The colored of the date at the configured .
Duration label
The calculated time span (e.g. "14 days", "10 bars", "2 weeks").
Boundary lines
markers at the start and end of the range for clarity.
Descriptive label
User-defined naming the period for identification purposes.
Boundary extend
Whether boundary lines span full chart height or only the .
Date labels
Optional showing the actual start and end dates at the boundaries.

How to use

  1. 1
    Select Date Range
    Click the Date Range tool from the measurement toolbar.
  2. 2
    Click the start date
    Click at the time coordinate where the range should begin on the chart.
  3. 3
    Drag to the end date
    horizontally and release at the end date. A preview highlight shows the range as you drag.
  4. 4
    Review the duration
    The span is displayed in the center of the range automatically.
  5. 5
    Adjust boundaries
    either boundary line after creation to expand or contract the range. The duration label updates.
  6. 6
    Add a label
    Enter a descriptive name in the settings to identify the period.
★
Pro tip: either boundary line after creation to expand or contract the range. The duration label updates automatically, making interactive adjustments seamless.

Configuration

Start date/time
Editable date-time coordinate for the range beginning. Can be typed in manually for precise positioning.
End date/time
Editable date-time coordinate for the range ending. Adjustable by dragging the boundary line.
Fill color
color and of the highlighted region. Use semi-transparent so bars remain visible.
Border
Line color, , and style (solid/dashed) of the boundary markers at each end of the range.
Descriptive label
User-defined displayed on or above the range for identification and categorization.
Duration format
Bars, trading days, calendar days, weeks, or months for the duration .
Boundary extend
Full chart height boundary lines or lines limited to the highlight only.
Show date labels
Display the start and end dates as labels at the boundary lines.
Label alignment
Position of the descriptive label — above, inside, or below the highlighted range.
Boundary line style
Solid or dashed line for the start and end boundaries. Dashed for less .

Use Cases / Application

  • Event windows — bracket known events such as earnings seasons, FOMC rate decisions, elections, or economic releases. The highlighted serves as a reminder of elevated volatility risk during these periods. Pre- the range before the event helps you prepare mentally for the expected volatility increase.
  • Historical consolidation — periods where price traded in a narrow range. The date range highlights the time component of consolidation visually, showing how long the range persisted before the breakout.
  • Cycle analysis — the time between successive cycle highs or lows. Track whether cycles are or contracting by comparing date range durations across multiple cycles. Shrinking cycle durations may indicate an impending trend change.
  • Performance periods — highlight specific periods for performance review, such as Q1 earnings season or historically bearish months for equities like September. returns within the highlighted to the overall trend.
  • windows (intraday) — specific trading sessions such as London open to NY close on intraday charts. Analyze -specific price behavior within the highlighted to identify session-dependent patterns.
  • periods — highlight the and out-of-sample periods on a chart to clearly separate training from validation data. This prevents by making the separation visually obvious.
  • Holiday trading analysis — periods around major holidays (Christmas, New Year, Thanksgiving) to analyze the historically lower-volume trading patterns during these weeks. The date range makes the holiday effect visually measurable.

Duration format selection

Choose the duration format that matches your analytical timeframe. On daily charts, trading days and calendar days are the most relevant formats. On weekly charts, use weeks for a clean . On monthly charts, use months. For intraday charts, bars format shows the exact number of candles in the range, which is useful for cycle analysis where cycle length is measured in bars rather than absolute time. Each format is appropriate for a specific analytical context.

Calendar days includes all days (including weekends and holidays) while trading days mode only counts sessions with actual price . For most analysis, trading days is more relevant because it reflects actual market . Use calendar days when comparing time spans that weekends or holidays where you want a consistent time measurement regardless of market closure. The difference between the two can be significant: a "14 trading day" range might span 18 calendar days.

Working with multiple date ranges

When using multiple date ranges on the same chart, color coding is essential. Use a consistent color scheme: green for bullish periods, red for bearish periods, blue for analysis windows, and yellow or orange for event risk windows. Each range should have a unique descriptive label so you can distinguish them at a glance. Without labels and color coding, multiple date ranges blend into a confusing rainbow of overlapping bands.

If date ranges overlap, reduce the fill so the overlapping region remains readable. A fill opacity of 20% per range means two overlapping ranges produce a 40% opacity region, which still allows the price bars beneath to be clearly visible. For three or more overlapping ranges, reduce opacity further or reconsider whether all those ranges are necessary for the current analysis.

Best Practices

★
Pro tip:Use date ranges to bracket event windows before they happen. Pre- the range before the event focuses your attention on price behavior during the event and helps you prepare for expected volatility changes.
★
Pro tip:Combine with measurements to analyze how price behaves during specific time periods. For example, whether the average range during earnings windows differs significantly from non-earnings periods.
★
Pro tip:Use semi-transparent (20–30% ) so price bars remain clearly readable inside the highlighted region. The fill should tint the zone, not obscure it.
ℹ
Note:Label each date range with a descriptive name in the settings so the purpose of the range is when you revisit the chart later.
ℹ
Note:Use full-height boundary lines for ranges to ensure the boundaries are visible even when price moves far from the highlighted area.

Common Mistakes

!
Caution:Date ranges that span across gaps (weekends, holidays) count only trading days in bar-based duration . Calendar days mode includes all days. Verify which mode you need for your analysis before relying on duration measurements.
!
Caution:A date range that extends too far into the creates a long highlighted region with no price . Keep the end date close to or behind the current bar for relevance.
!
Caution:Using too many date ranges on a single chart can create overlapping colored bands that become visually confusing. Limit yourself to 3–5 concurrent date ranges for clarity.
!
Caution:Date ranges on very compressed timeframes (e.g. 1-minute charts covering a 1-hour range) may be too narrow to display the duration label clearly. for label readability.
!
Caution:Overlapping date ranges with opaque (80%+) will completely hide the price bars beneath. Always use semi-transparent fills for date range highlights.

Comparison with related tools

Date Range
time-only measurement. Best for event windows and duration analysis.
Price Range
price-only measurement. Best for volatility and pattern height.
Date+Price Range
Two-dimensional . Best for combined price- analysis.
Vertical Line
Single time coordinate marker. Best for marking a specific date without a duration.

References

  • 1.Time measurement tools — TradingView Help
  • 2.Technical Analysis of Financial Markets — John J. Murphy
  • 3.Cycle Analysis — StockCharts ChartSchool
  • 4.The Profit Magic of Stock Transaction Timing — J.M. Hurst
  • 5.Seasonal Patterns in Financial Markets — Technical analysis reference
  • 6.Event Study Methodology — Academic reference

Related articles

  • Date and Price Range

    Charts / Drawing Tools / Measurement

    A rectangular region marking both a price range and a time range simultaneously. Combines the Price Range and Date Range tools into a single comprehensive…

  • Date and Price Range (legacy)

    Charts / Drawing Tools / Measurement

    A rectangular measurement tool that displays the elapsed time (bars or calendar days) and the price distance (points or percentage) between two points on…

  • Grid Range

    Charts / Drawing Tools / Measurement

    Design a grid trading ladder directly on the chart. Drag out the price range the grid should trade and the tool derives every rung price, order size,…

  • Long Position

    Charts / Drawing Tools / Measurement

    A measurement tool that visualizes a long (buy) trade setup with entry price, stop-loss level, and one or more take-profit targets, including the calculated…

  • Price Range

    Charts / Drawing Tools / Measurement

    A vertical bar spanning from low to high that measures the price distance between two levels. Useful for visualizing volatility, ATR-like ranges, and price…

  • Short Position

    Charts / Drawing Tools / Measurement

    A measurement tool that visualizes a short (sell) trade setup with entry price, stop-loss above, and take-profit targets below, including the calculated…

  • ABCD Pattern

    Charts / Drawing Tools / Patterns

    A four-point harmonic structure (A\u2013B\u2013C\u2013D) defined by the AB=CD leg equality rule. The simplest and most foundational harmonic pattern \u2014…

  • Anchored Note

    Charts / Drawing Tools / Annotation

    A sticky note pinned to a specific price-time coordinate. Combines the visibility of the Note tool with the positional persistence of anchored annotations.

  • Anchored Text

    Charts / Drawing Tools / Annotation

    A text label pinned to a specific price level and time coordinate. Unlike the fixed Text tool, anchored text scrolls with the chart, keeping the label…

Browse all knowledge base articles →