Appearance

Personalize your experience

Mode
Accent Color
Direction
Date and Price Range (legacy)

Date and Price Range

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 the chart.

Overview

The tool is a measurement that provides precise quantitative information about a selected section of the chart. When you from one to another, the tool displays both the span (time elapsed, bar count, or calendar days) and the vertical span (price difference in absolute or change) in labeled readouts. This dual- measurement makes it the most quantitative annotation in the tools toolbox.

This is essential for quantitative traders and analysts who need to the exact and magnitude of price moves, consolidation periods, and chart patterns. The tool combines the functionality of a date measure and a vertical price measure into a single annotation, saving chart space and reducing clutter. Instead of placing a and Date Range separately, a single produces both measurements with synchronized boundaries that share the same start and end points.

The tool differs from the Price+ annotation tool in that its primary purpose is measurement — displaying quantitative readouts — rather than zone highlighting. The measurement labels are the primary feature, with the fill being a secondary visual aid. Use the Price+Date Range annotation when you want to highlight a zone visually; use this measurement tool when you need precise numerical readouts of time and price.

The label prefix settings allow you to add descriptive before the measurement values. For example, "Range: 200 " or ": 14 days". This makes the tool more useful for charts and exported images where the measurements need to be self-explanatory to viewers who may not be familiar with the specific format of raw measurement labels.

Anatomy

$125.00$118.50Jan 1Jan 156.50 pt range14 day range
A date-price rectangle showing a 14-day, 6.50-point range from Jan 1 to Jan 15.
Measurement bound Price level Target / profit Price action Current price / midpoint Date span Grid rung / entry side
Left boundary
The start date and time of the measurement .
Right boundary
The end date and time of the measurement .
Top boundary
The price in the measured range.
Bottom boundary
The price in the measured range.
Time label
Elapsed time displayed in bars, trading days, or calendar days.
Price label
Price difference displayed in , ticks, pips, or .
Rectangle fill
Optional fill for the measurement area.
Label prefix
Custom prefix for the measurement labels.

How to draw

  1. 1
    Select Date-Price Range
    Click the tool from the measurement toolbar.
  2. 2
    Set the start point
    Click to place the first at the beginning of the to .
  3. 3
    Drag to set the end point
    diagonally to define both the and simultaneously.
  4. 4
    Release to see the measurement
    The tool displays elapsed time and price distance at the top or center of the .
  5. 5
    Fine-tune boundaries
    any edge or corner to adjust the . The measurement labels update in real time.
  6. 6
    Configure display
    Adjust the time display , price format, and decimal from the settings .
★
Pro tip: any edge or corner to adjust the . The measurement labels update in real time, making it easy to explore different time and price scenarios interactively.

Configuration

Border color / width / style
Appearance settings for the measurement perimeter.
Time display mode
Bars elapsed, trading days, or calendar days for the .
Price display format
, ticks, pips, or for the .
Decimal precision
Number of decimal places for both price and time readouts.
Label position
Top of , center, bottom, or hidden for the measurement labels.
Background fill
Optional fill for the measurement area with configurable .
Show boundary markers
Toggle the and vertical boundary lines at each edge.
Price label prefix
Custom prefix for the (e.g. "Range:", "Move:").
Time label prefix
Custom prefix for the time label (e.g. ":", "Span:").

Display modes

Bars elapsed
Number of bars between the left and boundaries.
Calendar days
Number of actual calendar days, including weekends and holidays.
Trading days
Number of exchange trading sessions between the two dates.
Price (absolute)
Absolute price difference between top and bottom boundaries in /pips.
Price (percentage)
change from the lower boundary to the upper boundary.
Price (log)
change for scale-independent comparisons.

Use Cases / Application

  • Price swing measurement — the and magnitude of price swings for volatility analysis. A 5-day, 200-pip swing has different implications than a 20-day, 200-pip swing. The former suggests momentum; the latter suggests a grinding, less decisive move.
  • Consolidation quantification — quantify the length and tightness of consolidation periods. A tight 10-day, 50-pip range suggests before expansion. The tells you how tight the range is; the time label tells you how long it has persisted.
  • Elliott Wave equality measurements — leg A vs leg C in Elliott Wave for equality measurements. If wave A was 100 over 10 days, check if wave C shows similar and magnitude. Equality of time or price between legs A and C is a common Fibonacci guideline.
  • Cycle analysis — track time between successive pivot highs or lows. Consistent time intervals suggest a dominant cycle worth for potential turn dates. The time label gives you the exact interval for precise cycle tracking.
  • Performance review — change over a specific for performance review. the return of a completed trade or a holding period for journal analysis with exact percentage values.
  • and contraction — the size of consecutive swing moves. If swings are getting shorter in both time and price, a of is developing that often precedes a significant breakout in either direction.
  • Volatility ratio calculation — the of the current bar and divide by the 20-bar average range. Use the to get a direct ratio reading for volatility comparison.

Working with different time modes

The choice between bars, trading days, and calendar days fundamentally changes what the time measurement tells you. Bars elapsed is the most direct — it counts every candle in the range regardless of calendar time. On a daily chart, bars elapsed equals trading days. On a 4-hour chart, there are 6 bars per trading day (24 hours divided by 4 hours). On a weekly chart, each bar is one week and bars elapsed equals weeks.

Trading days only counts sessions with actual trading activity, excluding weekends and holidays. This is the most useful mode for market-relative analysis because it measures price action time, not calendar time. Calendar days mode counts every day from start to end and is useful for real-world planning such as "this move took 3 weeks" but includes periods when the market was closed and no price action occurred. Choose the mode that matches your analytical context.

Best Practices

★
Pro tip:Use the to price moves across different instruments or timeframes. A 10- move means different things on a $30 stock vs a $300 stock — normalizes it.
★
Pro tip:For cycle analysis, the time from one major low to the next and with previous cycles. Consistent time intervals suggest a dominant cycle worth for turn dates.
★
Pro tip:When measuring swing magnitudes, ensure the top and bottom boundaries align with extremesrather than candle bodies. The true price excursion includes the full and tail.
ℹ
Note:Use trading days for market-relative measurements and calendar days mode for real-world intervals. A 5-trading-day move is 7 calendar days but only includes active market hours.
ℹ
Note:Use custom label prefixes to make exported chart images self-documenting. "Range: 200 " and ": 14 days" requires no additional explanation for viewers.

Common Mistakes

!
Caution:Date ranges that span across market gaps (weekends, holidays) may produce unexpected bar counts. Use trading days for market-relative measurements and calendar days mode for real-world intervals to avoid confusion.
!
Caution:The display calculates from the lower boundary to the upper boundary. For a move from top to bottom (a decline), the percentage will be negative. Verify the price direction matches your intended measurement before acting on the .
!
Caution:On log-scale charts, the midpoint of a does not correspond to the arithmetic midpoint. The tool always reports the actual arithmetic price difference regardless of the chart scale — do not visually estimate the midpoint.
!
Caution:Using bars elapsed on non-uniform timeframes ( charts, ) can produce misleading time measurements because the x- spacing between bars is variable.
!
Caution:A that is very tall but very narrow may not display its labels legibly. Adjust the zoom level or reposition the labels to the top or bottom for better .

Comparison with related tools

Date+Price Range (measurement)
Quantitative with precise readouts. Best for measuring swing magnitude and .
Price+Date Range (annotation)
zone highlighting with secondary labels. Best for marking consolidation ranges.
Price Range + Date Range (separate)
Two separate tools for and horizontal measurement. Use when only one dimension matters.
Short Position / Long Position
Entry/stop/target trade setup. Best for trade planning with R:R.

References

  • 1.Price and Date Range tool — TradingView Help
  • 2.Cycle Analysis — StockCharts ChartSchool
  • 3.Technical Analysis of Financial Markets — John J. Murphy
  • 4.The Profit Magic of Stock Transaction Timing — J.M. Hurst
  • 5.Cybernetic Analysis for Stocks and Futures — John F. Ehlers
  • 6.Swing Measurement Techniques — Technical analysis 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…

  • 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…

  • Date Range

    Charts / Drawing Tools / Measurement

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

  • 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…

  • Measure

    Charts / Drawing Tools / Zoom

    Measure price distance, time intervals, and percentage moves between two chart points.

  • 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…

  • Info Line

    Charts / Drawing Tools / Lines

    A two-point measurement line that displays live price, percentage change, ratio, and bar-count information. The info line functions as an on-chart…

  • 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…

Browse all knowledge base articles →