TanStack
Examples

Intervals and Financial Charts

Interval charts answer where a span begins and ends. The endpoints may represent time, uncertainty, a daily trading range, or a percentile envelope. Model those meanings explicitly with x1 and x2 or y1 and y2; do not force intervals through a point-value channel.

Choose the comparison

Reader questionStart with
When does each task or event start and finish?Horizontal interval timeline
How uncertain is each point estimate?Point plus low-high error bar
What were open, high, low, and close for each period?Candlestick
How does a percentile range evolve over time?Quantile ribbon plus median line
How do explicit lower and upper measurements change together?Range area in Lines and Areas

The chart should receive prepared endpoint fields with units that match the scale. Data and Channels defines these interval channel shapes.

Show scheduled spans

A timeline maps each task to a categorical lane and each start-end pair to a horizontal rectangle. The interval carries duration directly; its position does not depend on array order.

Use stable task keys and keep lane order explicit. Long lane labels rely on automatic guide measurement; verify them at the smallest supported width with Responsive Charts.

Preserve uncertainty bounds

An error bar combines a point estimate, a low-high link, and endpoint ticks. The chart renders the supplied interval; it does not decide whether the bounds are standard deviation, standard error, a confidence interval, or a credible interval.

Name the interval in the chart description or surrounding prose. Compose the link, caps, and point as separate layers using the Rules, Links, Arrows, Vectors, and Ticks reference and Dot and Hexagon Marks.

Encode open, high, low, and close

A candlestick uses a high-low wick and an open-close body. Directional color is secondary to the body endpoints and should not be the only way to distinguish an increasing period from a decreasing one.

Use one row per period with all four values. Render the wick as a link and the body as a ranged rectangle; preserve missing trading periods on the temporal domain instead of silently inventing observations.

Show an interval over time

A quantile ribbon combines a prepared lower percentile, median, and upper percentile for each time group. It shows how both location and spread evolve.

Prepare quantiles by time group in the application, then give the ribbon and median their own marks. Scales and D3 explains the preparation boundary; Line and Area Marks defines the range-area channels.

Production checks

  • State what each endpoint means and whether the interval is inclusive.
  • Use timezones and calendar boundaries intentionally for temporal spans.
  • Keep interval semantics in data fields rather than inferring them from color or row order.
  • Preserve exact values through a tooltip, table, or textual summary. See Tooltips and Focus.
  • Use semantic controls and application state when intervals become editable; see Interactions and Selections.
  • Verify essential distinctions without color in Accessibility.

Rectangle channel details are in Bar and Rect Marks.