WOLFRAM

DateListStepPlot[{{date1,y1},{date2,y2},}]

plots the values yi in steps at a sequence of dates.

DateListStepPlot[{y1,y2,},datespec]

plots the values yi in steps with dates at equal intervals specified by datespec.

DateListStepPlot[tseries]

plots the time series tseries.

DateListStepPlot[{data1,data2,}]

plots data from all the datai.

DateListStepPlot[,step]

plots using steps specified by step.

DateListStepPlot[{,w[datai],}]

plots data datai with features defined by the symbolic wrapper w.

Details and Options

Examples

open allclose all

Basic Examples  (4)Summary of the most common use cases

Create a plot that stays level until the next date:

Out[2]=2

Draw the date points in the middle of the steps:

Out[3]=3

Plot monthly values, starting in August 2000:

Out[1]=1

Plot multiple curves with a legend:

Out[2]=2

Add labels for each data:

Out[3]=3

Plot curves without the vertical segments:

Out[2]=2

Scope  (45)Survey of the scope of standard use cases

Data  (11)

Steps are drawn through the date points:

Out[2]=2

Plot time and event series:

Out[1]=1
Out[2]=2

Plot a series of data using an initial starting date or time:

Out[1]=1

Plot data spaced equally in time between a starting and ending date:

Out[1]=1

Plot data gathered on the 15^(th) day of each month, starting in January:

Out[1]=1

Dates given as DateString specifications:

Out[1]=1

Use AbsoluteTime specifications:

Out[1]=1

Show multiple time series:

Out[2]=2

The plot range is selected automatically:

Out[1]=1

Use PlotRange to focus in on areas of interest:

Out[1]=1

Use ScalingFunctions to scale the axes:

Out[1]=1

Tabular Data  (1)

Get tabular data for historical populations of several countries:

Out[1]=1

Plot the population of France from 1940 to 2020:

Out[2]=2

Plot the populations of France, Germany and Australia:

Out[3]=3

Include legends for the plot, using the column names:

Out[4]=4

Special Data  (6)

Use Quantity to include units with the data:

Out[1]=1

Plot data in a QuantityArray:

Out[1]=1
Out[2]=2

Specify the units used with TargetUnits:

Out[3]=3

Numeric values in an Association are used as the coordinates:

Out[1]=1

Numeric keys and values in an Association are used as the and coordinates:

Out[2]=2

Plot TimeSeries directly:

Out[1]=1
Out[2]=2

The weights in WeightedData are ignored:

Out[1]=1

Use a sparse array to represent the values:

Out[1]=1

Wrappers  (8)

Use wrappers on individual data, datasets, or collections of datasets:

Out[1]=1

Wrappers can be nested:

Out[1]=1

Use the value of each point as a tooltip:

Out[1]=1

Use a specific label for all the points:

Out[2]=2

Use PopupWindow to provide additional drilldown information:

Out[1]=1

Button can be used to trigger any action:

Out[1]=1

Use Annotation for dynamic action when the mouse enters the plot:

Out[2]=2

Use Hyperlink to jump to the specified link when clicked:

Out[2]=2

Use StatusArea to display a string in the status area of the current notebook:

Out[2]=2

Labeling and Legending  (13)

Label data with Labeled:

Out[2]=2

Label data with PlotLabels:

Out[2]=2

Place the label near the points at an date:

Out[1]=1

Use a scaled position:

Out[1]=1

Specify the text position relative to the point:

Out[2]=2

Label points with automatically positioned text:

Out[1]=1

Place the labels relative to the points:

Out[2]=2

Specify the maximum size of labels:

Out[2]=2

Use the full label:

Out[3]=3

For dense sets of points, some labels may be turned into tooltips by default:

Out[2]=2

Increasing the size of the plot will show more labels:

Out[3]=3

Label data automatically with Callout:

Out[1]=1

Place a label with a specific location:

Out[1]=1

Include legends for each curve:

Out[2]=2

Use Legended to provide a legend for a specific dataset:

Out[2]=2

Use Placed to change the legend location:

Out[3]=3

Use association keys as labels:

Out[2]=2

Plots usually have interactive callouts showing the coordinates when you mouse over them:

Out[1]=1

Including specific wrappers or interactions, such as tooltips, turns off the interactive features:

Out[2]=2

Presentation  (6)

Multiple curves are automatically colored to be distinct:

Out[3]=3

Provide explicit styling to different curves:

Out[4]=4

Include legends for each curve:

Out[5]=5

Use Legended to provide a legend for a specific dataset:

Out[6]=6

Provide an interactive Tooltip for the curve:

Out[2]=2

Use tooltips for each point:

Out[3]=3

Create filled plots:

Out[2]=2

Use shapes to distinguish different datasets:

Out[2]=2

Use a theme with simple ticks in a bold color scheme:

Out[2]=2

Use a theme with bright colors on a dark background:

Out[3]=3

Plot the data in a stacked layout:

Out[3]=3

Options  (47)Common values & functionality for each option

ClippingStyle  (1)

Omit clipped regions of the plot:

Out[2]=2

Show clipped regions as red at the bottom and the top:

Out[3]=3

Use PlotRange->All to not clip:

Out[4]=4

ColorFunction  (4)

Color with a named color scheme:

Out[2]=2

Color by scaled and coordinates:

Out[2]=2
Out[3]=3

Fill with the color used for the curve:

Out[2]=2

ColorFunction has higher priority than PlotStyle for coloring the curve:

Out[2]=2

ColorFunctionScaling  (2)

Color the line based on scaled value:

Out[2]=2

Color the line based on unscaled value:

Out[2]=2

DateFunction  (1)

By default, numeric times correspond to AbsoluteTime:

Out[2]=2

Interpret them as UnixTime:

Out[3]=3

DateTicksFormat  (1)

Control how dates are formatted in labels:

Out[2]=2

Filling  (2)

Explicitly specify the filling style for different plots:

Out[2]=2

Fills that overlap combine using opacity by default:

Out[2]=2

Fill from the second curve to the first:

Out[3]=3

Fill the region between two curves with light gray:

Out[4]=4

FillingStyle  (3)

Fill with red to the axis:

Out[2]=2

Fill with red below the axis and with blue above:

Out[3]=3

Fill with 50% opaque orange:

Out[2]=2

Use a variable filling style obtained from ColorFunction:

Out[2]=2

GridLines  (1)

Put grids across a plot:

Out[2]=2

Draw grid lines at the specific positions:

Out[3]=3

GridLinesStyle  (1)

Use dotted grid lines:

Out[2]=2

Joined  (1)

By default, the horizontal steps are joined by vertical segments:

Out[2]=2

Use Joined->False to create a plot without the vertical segments:

Out[3]=3

LabelingSize  (4)

Textual labels are shown at their actual sizes:

Out[4]=4

Image labels are automatically resized:

Out[1]=1

Specify a maximum size for textual labels:

Out[1]=1

Specify a maximum size for image labels:

Out[2]=2

Show image labels at their natural sizes:

Out[1]=1

Mesh  (1)

Use Mesh->Full to show the point for each step:

Out[2]=2
Out[3]=3

Use different mesh specifications:

Out[4]=4

MeshFunctions  (1)

Show seven mesh levels in the direction (red) and 10 mesh levels in the direction (blue):

Out[2]=2

MeshShading  (1)

Alternate red and blue segments of equal width in the direction:

Out[2]=2

MeshShading can be used with PlotStyle:

Out[3]=3

MeshStyle  (1)

Use different mesh directives:

Out[2]=2

PlotHighlighting  (1)

Plots have interactive coordinate callouts with the default setting PlotHighlightingAutomatic:

Out[1]=1

PlotLabel  (1)

Add an overall label to the plot:

Out[1]=1

PlotLabels  (4)

Specify text to label curves:

Out[3]=3

Place the label above the data:

Out[2]=2

Place the label below the data at a specific date:

Out[3]=3

PlotLabels->Automatic uses keys of an association as data labels:

Out[1]=1

Use None to not add a label:

Out[2]=2

PlotLayout  (1)

By default, curves are overlaid on each other:

Out[3]=3

Plot the data in a stacked layout:

Out[4]=4

PlotLegends  (1)

Generate a legend using labels:

Out[2]=2

Legends use the same styles as the plot:

Out[3]=3

Place the legend inside the plot:

Out[4]=4

PlotMarkers  (2)

Use PlotMarkers->Automatic to show the point for each step:

Out[2]=2
Out[3]=3

Automatically use colors and shapes to distinguish sets of data:

Out[2]=2

Use text or typeset labels to distinguish datasets:

Out[3]=3

Use the same symbol for all the sets of data:

Out[4]=4

PlotRange  (1)

PlotRange is automatically calculated:

Out[2]=2

Show the whole dataset:

Out[3]=3

Choose the range to show:

Out[4]=4

PlotStyle  (2)

Use different plot style directives:

Out[2]=2

By default, different styles are chosen for multiple plots:

Out[2]=2

Explicitly specify the style for different plots:

Out[3]=3

PlotTheme  (1)

Use a theme with simple styling in a bright color scheme:

Out[2]=2

Change the color scheme:

Out[3]=3

Use a theme with minimal styling:

Out[4]=4

ScalingFunctions  (7)

By default, plots have linear scales in each direction:

Out[1]=1

Use a log scale in the direction:

Out[1]=1

Use a linear scale in the direction that shows smaller numbers at the top:

Out[1]=1

Use a reciprocal scale in the direction:

Out[1]=1

Use a scale defined by a function and its inverse:

Out[1]=1

Positions in FrameTicks and GridLines are automatically scaled:

Out[1]=1

PlotRange is automatically scaled:

Out[1]=1

TargetUnits  (1)

Units are automatically extracted from the data:

Out[1]=1

Specify the units:

Out[2]=2

Applications  (7)Sample problems that can be solved with this function

Plot a digital signal:

Out[1]=1

Visualize the number of items in an inventory:

Out[1]=1

Show the total precipitation of Boston Logan International Airport from January 1, 2000, to December 31, 2005:

Out[1]=1

Plot stepwise the GDP of France from 1985 to 2005:

Out[1]=1

Show values averaged over monthly intervals:

Out[2]=2
Out[3]=3

Show the simulation of a Poisson process with :

Out[3]=3

Show the simulation of a M/M/1 queue where the state is the number of jobs in the system:

Out[1]=1
Out[2]=2

Properties & Relations  (4)Properties of the function, and connections to other functions

DateListStepPlot does not interpolate between values:

Out[2]=2

Use DateListPlot to linearly interpolate between values:

Out[3]=3

Use cubic interpolation:

Out[4]=4

ListStepPlot does not interpret the values as being dates or times:

Out[2]=2

DateListStepPlot plots values associated with dates:

Out[2]=2

Use DateHistogram to plot counts from a list of dates:

Out[3]=3

Use TradingChart for a chart showing prices and volume for each date :

Out[2]=2
Wolfram Research (2015), DateListStepPlot, Wolfram Language function, https://reference.wolfram.com/language/ref/DateListStepPlot.html (updated 2025).
Wolfram Research (2015), DateListStepPlot, Wolfram Language function, https://reference.wolfram.com/language/ref/DateListStepPlot.html (updated 2025).

Text

Wolfram Research (2015), DateListStepPlot, Wolfram Language function, https://reference.wolfram.com/language/ref/DateListStepPlot.html (updated 2025).

Wolfram Research (2015), DateListStepPlot, Wolfram Language function, https://reference.wolfram.com/language/ref/DateListStepPlot.html (updated 2025).

CMS

Wolfram Language. 2015. "DateListStepPlot." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2025. https://reference.wolfram.com/language/ref/DateListStepPlot.html.

Wolfram Language. 2015. "DateListStepPlot." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2025. https://reference.wolfram.com/language/ref/DateListStepPlot.html.

APA

Wolfram Language. (2015). DateListStepPlot. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/DateListStepPlot.html

Wolfram Language. (2015). DateListStepPlot. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/DateListStepPlot.html

BibTeX

@misc{reference.wolfram_2025_dateliststepplot, author="Wolfram Research", title="{DateListStepPlot}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/DateListStepPlot.html}", note=[Accessed: 29-March-2025 ]}

@misc{reference.wolfram_2025_dateliststepplot, author="Wolfram Research", title="{DateListStepPlot}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/DateListStepPlot.html}", note=[Accessed: 29-March-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_dateliststepplot, organization={Wolfram Research}, title={DateListStepPlot}, year={2025}, url={https://reference.wolfram.com/language/ref/DateListStepPlot.html}, note=[Accessed: 29-March-2025 ]}

@online{reference.wolfram_2025_dateliststepplot, organization={Wolfram Research}, title={DateListStepPlot}, year={2025}, url={https://reference.wolfram.com/language/ref/DateListStepPlot.html}, note=[Accessed: 29-March-2025 ]}