DateListPlot

DateListPlot[{{date1,y1},{date2,y2},,{daten,yn}}]

plots points with values yi at a sequence of dates.

DateListPlot[{y1,y2,,yn},datespec]

plots points with dates at equal intervals specified by datespec.

DateListPlot[tseries]

plots the time series tseries.

DateListPlot[{data1,data2,}]

plots data from all the datai.

DateListPlot[{,w[datai],}]

plots datai with features defined by the symbolic wrapper w.

Details and Options

Examples

open allclose all

Basic Examples  (5)

Plot data with explicit date values:

Plot monthly values, starting in August 2000:

Plot multiple time series with a legend:

Add labels for the data:

Retrieve and plot a historical stock price:

Scope  (46)

Data  (9)

Plot a time series of temperatures:

Dates given as AbsoluteTime specifications:

Dates given as DateString specifications:

Dates given as elided DateList specifications:

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

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

Plot data gathered every 90 days, starting on January 1, 2006:

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

Dates determined by an ending date and a step:

Use ScalingFunctions to scale the axes:

Special Data  (5)

Use Quantity to include units with the data:

Plot data in a QuantityArray:

Specify the units used with TargetUnits:

Plot TimeSeries directly:

Numeric values in an Association are used as the coordinates:

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

Plot data with uncertainty:

Use intervals:

Wrappers  (8)

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

Wrappers can be nested:

Use the value of each point as a tooltip:

Use a specific label for all the points:

Use PopupWindow to provide additional drilldown information:

Button can be used to trigger any action:

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

Use Hyperlink to jump to the specified link when clicked:

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

Labeling and Legending  (15)

Label data with Labeled:

Label points with automatically positioned text:

Place the labels relative to the points:

Label data with PlotLabels:

Place the label near the points at a date:

Use a scaled position:

Specify the text position relative to the point:

Include legends for each curve:

Use callouts to label curves:

Place a callout at a named location:

Place a callout at a specific location:

Specify the maximum size of labels:

Use the full label:

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

Increasing the size of the plot will show more labels:

Use Legended to provide a legend for a specific dataset:

Use Placed to change the legend location:

Use Association keys as labels:

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

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

Choose from multiple interactive highlighting effects:

Presentation  (9)

Multiple curves are automatically colored to be distinct:

Provide explicit styling to different curves:

Include legends for each dataset:

Use Legended to provide a legend for a specific dataset:

Use a theme with detailed ticks and grid lines:

Use a more stylized theme:

Create filled plots:

Fill between the curves:

Use shapes to distinguish different datasets:

Plot the data in a stacked layout:

Plot the data as percentiles of the total of the values:

Show multiple curves in a row of separate panels:

Use a column instead of a row:

Use multiple rows or columns:

Options  (58)

AspectRatio  (2)

By default, DateListPlot uses a fixed height to width ratio for the plot:

Use AspectRatio1 to make the height the same as the width:

DateFunction  (2)

Prepend a year to create dates from {month,day} lists:

Define functions for interpreting ambiguous date strings:

DateTicksFormat  (1)

Specify the format of date ticks as DateString elements:

Epilog  (1)

Place text using a shortened DateList as the coordinate:

Filling  (1)

Fill from data points to the bottom:

Fill to the bottom with points joined:

GridLines  (1)

Include grid lines at specific dates:

Make the first grid line Blue:

IntervalMarkers  (3)

By default, uncertainties are capped:

Use bars to denote uncertainties without caps:

Use bands to represent uncertainties:

IntervalMarkersStyle  (2)

Uncertainties automatically inherit the plot style:

Specify the style for uncertainties:

Joined  (2)

Plot data with points joined by a line:

Plot multiple datasets with points joined:

Only join points for the first dataset:

LabelingFunction  (3)

By default, points are automatically labeled with strings:

Use LabelingFunction->None to suppress the labels:

Put the labels above the points:

Put them in a tooltip:

LabelingSize  (4)

Textual labels are shown at their actual sizes:

Image labels are automatically resized:

Specify a maximum size for textual labels:

Specify a maximum size for image labels:

Show image labels at their natural sizes:

PlotHighlighting  (9)

Plots have interactive coordinate callouts with the default setting PlotHighlightingAutomatic:

Use PlotHighlightingNone to disable the highlighting for the entire plot:

Move the mouse over a set of points to highlight it using arbitrary graphics directives:

Move the mouse over the points to highlight them with balls and labels:

Move the mouse over the curve to highlight it with a label and droplines to the axes:

Move the mouse over the plot to highlight it with a slice showing values corresponding to the position:

Move the mouse over the plot to highlight it with a slice showing values corresponding to the position:

Use a component that shows the points on the plot closest to the position of the mouse cursor:

Specify the style for the points:

Use a component that shows the coordinates on the points closest to the mouse cursor:

Use Callout options to change the appearance of the label:

Combine components to create a custom effect:

PlotLabel  (1)

Add an overall label to the plot:

PlotLabels  (4)

Specify text to label curves:

Place the label above the data:

Place the label below the data at a specific date:

Use a callout to label the curve:

PlotLabelAutomatic uses keys of an Association as data labels:

Use None to not add a label:

PlotLayout  (4)

By default, curves are overlaid on each other:

Plot the data in a stacked layout:

Plot the data as percentiles of the total of the values:

Place each curve in a separate panel using shared axes:

Use a row instead of a column:

Label the individual panels:

Use multiple columns or rows:

PlotLegends  (6)

PlotLegends matches up styles in the plot:

PlotLegends matches up markers in the plot:

Use a list of legend labels:

Use MetaInformation from a TimeSeries:

See the available MetaInformation:

The metal list can be extracted directly:

Visualize the data:

Use Placed to specify legend placement:

Use PointLegend to change legend appearance:

PlotRange  (1)

Restrict the range of dates over which to plot:

PlotTheme  (2)

Use a theme with a dark background in a high-contrast color scheme:

Change the color scheme:

Prolog  (1)

Place text using a shortened DateList as the coordinate:

ScalingFunctions  (7)

By default, plots have linear scales in each direction:

Use a log scale in the direction:

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

Use a reciprocal scale in the direction:

Use a scale defined by a function and its inverse:

Positions in FrameTicks and GridLines are automatically scaled:

PlotRange is automatically scaled:

TargetUnits  (1)

Units are automatically extracted from the data:

Specify the units to use:

Applications  (2)

Get stock price data:

Plot data gathered at regular intervals and stored without explicit dates:

Modify the ticks:

Properties & Relations  (2)

Date coordinates are plotted as absolute times:

A ListPlot using the AbsoluteTime values:

DateListLogPlot plots datebased data on a logarithmic scale:

Wolfram Research (2007), DateListPlot, Wolfram Language function, https://reference.wolfram.com/language/ref/DateListPlot.html (updated 2023).

Text

Wolfram Research (2007), DateListPlot, Wolfram Language function, https://reference.wolfram.com/language/ref/DateListPlot.html (updated 2023).

CMS

Wolfram Language. 2007. "DateListPlot." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2023. https://reference.wolfram.com/language/ref/DateListPlot.html.

APA

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

BibTeX

@misc{reference.wolfram_2023_datelistplot, author="Wolfram Research", title="{DateListPlot}", year="2023", howpublished="\url{https://reference.wolfram.com/language/ref/DateListPlot.html}", note=[Accessed: 19-March-2024 ]}

BibLaTeX

@online{reference.wolfram_2023_datelistplot, organization={Wolfram Research}, title={DateListPlot}, year={2023}, url={https://reference.wolfram.com/language/ref/DateListPlot.html}, note=[Accessed: 19-March-2024 ]}