# DateListPlot

DateListPlot[{{date1,v1},{date2,v2},}]

plots points with values vi at a sequence of dates.

DateListPlot[{v1,v2,},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

• Possible forms of datei include:
•  DateObject,TimeObject date or time object "string" DateString specification {y,m,d,h,m,s} DateList specification {y},{y,m},{y,m,d},… shortened date list t absolute time given as a single number
• In shortened date lists, omitted elements are taken to have default values {y,1,1,0,0,0}.
• Possible forms of datespec include:
•  {start,end} dates from start to end in equal increments {start,Automatic,Δt} dates beginning with start in increments Δt {Automatic,end,Δt} dates ending with end in increments Δt start dates with increments determined by the form of start
• The Δt in datespec can be a {y,m,d,h,m,s} date list specification or any of the special forms "Year", "Quarter", "Month", "Week", "Day", "Hour", "Minute", "Second", and "Millisecond".
• If no explicit Δt is given, the increments used will be the smallest time unit specified explicitly in start.
• Data values vi can be given in the following forms:
•  vi a real-valued number Quantity[vi,unit] a quantity with a unit
• Values vi that are not of the preceding form are taken to be missing and are not shown.
• The datai have the following forms and interpretations:
•  <|"k1"v1,"k2"v2,…|> values {v1,v2,…} <|date1v1,date2v2,…|> key-value pairs {{date1,v1},{date2,v2},…} TimeSeries, EventSeries time-value pairs QuantityArray magnitudes WeightedData unweighted values
• The following wrappers w can be used for the datai:
•  Annotation[datai,label] provide an annotation for the data Button[datai,action] define an action to execute when the points are clicked Callout[datai,label] label the data with a callout EventHandler[datai,…] define a general event handler for the points Hyperlink[datai,uri] make the points a hyperlink Labeled[datai,label] label the data Legended[datai,label] identify the data in a legend PopupWindow[datai,cont] attach a popup window to the points StatusArea[datai,label] display in the status area on mouseover Style[datai,styles] show the points using the specified styles Tooltip[datai,label] attach a tooltip to the points Tooltip[datai] use data values as tooltip for the points
• Wrappers w can be applied at multiple levels:
•  {…,w[vi],…} wrap the value vi in a list {…,w[{datei,vi}],…} wrap the point {datei,vi} w[datai] wrap the data datai w[{data1,…}] wrap a collection of data w1[w2[…]] use nested wrappers
• In DateListPlot, Labeled and Placed allow the following positions:
•  Automatic automatically placed labels Above, Below, Before, After positions around the data date near the data at date Scaled[s] scaled position s along the data {s,Above},{s,Below},… relative position at position s along the data {pos,epos} epos in label placed at relative position pos of the data
• DateListPlot has the same options as Graphics, with the following additions and changes:
•  AspectRatio 1/GoldenRatio ratio of height to width Axes Automatic whether to draw axes ClippingStyle None what to draw when lines are clipped ColorFunction Automatic how to determine the coloring of lines ColorFunctionScaling True whether to scale arguments to ColorFunction DataRange Automatic the range of x values to assume for data DateFunction Automatic how to convert dates to standard form DateTicksFormat Automatic format for date tick labels Filling None how to fill in stems for each point FillingStyle Automatic style to use for filling Frame True whether to put a frame around the plot InterpolationOrder None the polynomial degree of curves used in joining data points Joined False whether to join points LabelingSize Automatic maximum size of callouts and labels MaxPlotPoints Infinity the maximum number of points to include Mesh None how many mesh points to draw on each line MeshFunctions {#1&} how to determine the placement of mesh points MeshShading None how to shade regions between mesh points MeshStyle Automatic the style for mesh points Method Automatic methods to use PerformanceGoal \$PerformanceGoal aspects of performance to try to optimize PlotLabel None overall label for the plot PlotLabels None labels for data PlotLayout "Overlaid" how to position data PlotLegends None legends for datasets PlotMarkers None markers to use to indicate each point PlotRange Automatic range of values to include PlotRangeClipping True whether to clip at the plot range PlotStyle Automatic graphics directives to determine styles of points PlotTheme \$PlotTheme overall theme for the plot ScalingFunctions None how to scale individual coordinates TargetUnits Automatic units to display in the plot
• DataRange determines how values {v1,,vn} are interpreted into {{date1,y1},,{xn,yn}}. Possible settings include:
•  Automatic,All uniform from 1 to n {xmin,xmax} uniform from xmin to xmax
• In general, a list of pairs {{x1,y1},{x2,y2},} is interpreted as a list of points, but the setting forces it to be interpreted as multiple data {{y11,y12},{y21,y23},}.
• Typical settings for PlotLegends include:
•  None no legend Automatic automatically determine legend {lbl1,lbl2,…} use lbl1, lbl2, … as legend labels Placed[lspec,…] specify placement for legend
• ScalingFunctions->"scale" scales the coordinate; ScalingFunctions{"scalex","scaley"} scales both the and coordinates.
• All explicit coordinates in Prolog, Epilog, Ticks, etc. are taken to be dates. »

# Examples

open allclose all

## Basic Examples(5)

Plot data with explicit date values:

 In[1]:=
 In[2]:=
 Out[2]=

Plot monthly values, starting in August 2000:

 In[1]:=
 Out[1]=

Plot multiple time series with a legend:

 In[1]:=
 In[2]:=
 Out[2]=

 In[1]:=
 Out[1]=

Retrieve and plot a historical stock price:

 In[1]:=
 Out[1]=