WOLFRAM

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)Summary of the most common use cases

Plot data with explicit date values:

Out[2]=2

Plot monthly values, starting in August 2000:

Out[1]=1

Plot multiple time series with a legend:

Out[2]=2

Add labels for the data:

Out[1]=1

Retrieve and plot a historical stock price:

Out[1]=1

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

Data  (9)

Plot a time series of temperatures:

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

Dates given as AbsoluteTime specifications:

Out[2]=2

Dates given as DateString specifications:

Out[2]=2

Dates given as elided DateList specifications:

Out[2]=2

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

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

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

Out[1]=1

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

Out[1]=1

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

Out[2]=2

Dates determined by an ending date and a step:

Out[1]=1

Use ScalingFunctions to scale the axes:

Out[1]=1

Special Data  (5)

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

Plot TimeSeries directly:

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

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 data with uncertainty:

Out[1]=1

Use intervals:

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

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

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  (15)

Label data with Labeled:

Out[4]=4

Label points with automatically positioned text:

Out[1]=1

Place the labels relative to the points:

Out[2]=2

Label data with PlotLabels:

Out[2]=2

Place the label near the points at a date:

Out[1]=1

Use a scaled position:

Out[1]=1

Specify the text position relative to the point:

Out[2]=2

Include legends for each curve:

Out[2]=2

Use callouts to label curves:

Out[2]=2

Place a callout at a named location:

Out[1]=1

Place a callout at a specific location:

Out[1]=1

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

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

Choose from multiple interactive highlighting effects:

Out[1]=1

Presentation  (9)

Multiple curves are automatically colored to be distinct:

Out[2]=2

Provide explicit styling to different curves:

Out[2]=2

Include legends for each dataset:

Out[1]=1

Use Legended to provide a legend for a specific dataset:

Out[2]=2

Use a theme with detailed ticks and grid lines:

Out[2]=2

Use a more stylized theme:

Out[3]=3

Create filled plots:

Out[2]=2

Fill between the curves:

Out[3]=3

Use shapes to distinguish different datasets:

Out[2]=2

Plot the data in a stacked layout:

Out[3]=3

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

Out[4]=4

Show multiple curves in a row of separate panels:

Out[1]=1

Use a column instead of a row:

Out[2]=2

Use multiple rows or columns:

Out[3]=3

Options  (58)Common values & functionality for each option

AspectRatio  (2)

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

Out[2]=2

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

Out[1]=1

DateFunction  (2)

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

Out[2]=2

Define functions for interpreting ambiguous date strings:

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

DateTicksFormat  (1)

Specify the format of date ticks as DateString elements:

Out[2]=2

Epilog  (1)

Place text using a shortened DateList as the coordinate:

Out[1]=1

Filling  (1)

Fill from data points to the bottom:

Out[1]=1

Fill to the bottom with points joined:

Out[2]=2

GridLines  (1)

Include grid lines at specific dates:

Out[1]=1

Make the first grid line Blue:

Out[2]=2

IntervalMarkers  (3)

By default, uncertainties are capped:

Out[1]=1

Use bars to denote uncertainties without caps:

Out[1]=1

Use bands to represent uncertainties:

Out[1]=1

IntervalMarkersStyle  (2)

Uncertainties automatically inherit the plot style:

Out[1]=1

Specify the style for uncertainties:

Out[1]=1

Joined  (2)

Plot data with points joined by a line:

Out[1]=1

Plot multiple datasets with points joined:

Out[3]=3

Only join points for the first dataset:

Out[4]=4

LabelingFunction  (3)

By default, points are automatically labeled with strings:

Out[2]=2

Use LabelingFunction->None to suppress the labels:

Out[1]=1

Put the labels above the points:

Out[1]=1

Put them in a tooltip:

Out[2]=2

LabelingSize  (4)

Textual labels are shown at their actual sizes:

Out[2]=2

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

PlotHighlighting  (9)

Plots have interactive coordinate callouts with the default setting PlotHighlightingAutomatic:

Out[1]=1

Use PlotHighlightingNone to disable the highlighting for the entire plot:

Out[2]=2

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

Out[1]=1

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

Out[1]=1

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

Out[1]=1

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

Out[1]=1

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

Out[1]=1

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

Out[1]=1

Specify the style for the points:

Out[2]=2

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

Out[1]=1

Use Callout options to change the appearance of the label:

Out[2]=2

Combine components to create a custom effect:

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

Use a callout to label the curve:

Out[4]=4

PlotLabelAutomatic uses keys of an Association as data labels:

Out[1]=1

Use None to not add a label:

Out[2]=2

PlotLayout  (4)

By default, curves are overlaid on each other:

Out[3]=3

Plot the data in a stacked layout:

Out[4]=4

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

Out[5]=5

Place each curve in a separate panel using shared axes:

Out[1]=1

Use a row instead of a column:

Out[2]=2

Label the individual panels:

Out[1]=1

Use multiple columns or rows:

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

PlotLegends  (6)

PlotLegends matches up styles in the plot:

Out[1]=1

PlotLegends matches up markers in the plot:

Out[1]=1

Use a list of legend labels:

Out[1]=1

Use MetaInformation from a TimeSeries:

See the available MetaInformation:

Out[2]=2

The metal list can be extracted directly:

Out[3]=3

Visualize the data:

Out[4]=4

Use Placed to specify legend placement:

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

Use PointLegend to change legend appearance:

Out[1]=1

PlotRange  (1)

Restrict the range of dates over which to plot:

Out[1]=1

PlotTheme  (2)

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

Out[1]=1

Change the color scheme:

Out[1]=1

Prolog  (1)

Place text using a shortened DateList as the coordinate:

Out[1]=1

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 to use:

Out[2]=2

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

Get stock price data:

Out[2]=2

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

Out[2]=2

Modify the ticks:

Out[3]=3

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

Date coordinates are plotted as absolute times:

Out[2]=2

A ListPlot using the AbsoluteTime values:

Out[4]=4

DateListLogPlot plots datebased data on a logarithmic scale:

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

Text

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

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

CMS

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

Wolfram Language. 2007. "DateListPlot." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2025. 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

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

BibTeX

@misc{reference.wolfram_2025_datelistplot, author="Wolfram Research", title="{DateListPlot}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/DateListPlot.html}", note=[Accessed: 01-April-2025 ]}

@misc{reference.wolfram_2025_datelistplot, author="Wolfram Research", title="{DateListPlot}", year="2025", howpublished="\url{https://reference.wolfram.com/language/ref/DateListPlot.html}", note=[Accessed: 01-April-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_datelistplot, organization={Wolfram Research}, title={DateListPlot}, year={2025}, url={https://reference.wolfram.com/language/ref/DateListPlot.html}, note=[Accessed: 01-April-2025 ]}

@online{reference.wolfram_2025_datelistplot, organization={Wolfram Research}, title={DateListPlot}, year={2025}, url={https://reference.wolfram.com/language/ref/DateListPlot.html}, note=[Accessed: 01-April-2025 ]}