Getting started
Chart interface
Web components
Chart internals
Data integration
Frameworks and bundlers
Mobile development
Time Span Events
Term structures

Time Span Events


A time series chart plots data over time. Events related to the time series — news stories, stock dividend payments, corporate earnings reports — also happen over time.

ChartIQ enables you to annotate time series charts with event markers: HTML DOM elements or canvas drawings superimposed on the chart at the date and time the events occurred. (See the Markers tutorial.)

But not all events happen in a single moment or at a point in time; some take place over a span of time. They have a life cycle — a beginning, middle, and end — events such as institutional trades (which can take hours and comprise multiple transactions), CEO tenures, economic trends, weather events.

The ChartIQ Time Span Events module displays events that extend over a period of time (including ongoing events) and relates them to the time series chart.

A time span event can be depicted two ways: as a horizontal bar or as an icon followed by a dashed line (or tail). Both depictions show the start, end, and duration of the event.

Time span events also include serial events: point-in-time events that recur over a span of time; for example, quarterly reports or earnings conference calls.

Time span events are displayed in a dedicated panel below the time series chart. Each event type is presented in its own horizontal "swim lane." For example, in the chart below, all stock orders are displayed in the top row of the panel, all CEO tenures in the middle row, all news events in the bottom row.

Chart with time span events in swim lanes. Figure. Chart with time span events in swim lanes.


Time span event markers are interactive.

Hovering your mouse over a marker highlights the time series data range that is concurrent with the time span event. Selecting a marker makes the highlighting persistent and opens a pop-up display containing a short description of the event.

If the time span event contains sub-events, small markers (typically circles or squares, depending on style settings) appear in the highlighted area to indicate the sub-events.

Sub-events are point-in-time events that constitute the time span event; for example, the individual transactions of an institutional trade. Selecting a sub-event marker opens a pop-up display containing information about the sub-event.

Time span events with highlighted data range and pop-up displays. Figure. Time span events with highlighted data range and pop-up displays.


The ChartIQ Time Span Events module simplifies analysis of complex, long-running events by providing a visualization of events and their constituent elements.

Note: The Time Span Events module is also known as Life Cycle Events.

Next steps