DateListPlot [{{date₁,y₁},{date₂,y₂},…,{date_n,y_n}}]

plots points with values y_i at a sequence of dates.

DateListPlot [{y₁,y₂,…,y_n},datespec]

plots points with dates at equal intervals specified by datespec.

DateListPlot [tseries]

plots the time series tseries.

DateListPlot [{data₁,data₂,…}]

plots data from all the data_i.

DateListPlot [{…,w[data_i],…}]

plots data_i with features defined by the symbolic wrapper w.

• DateListPlot is also known as a time series plot or chronological plot.
• Regular data {y₁,…,y_n} is plotted as a functional curve through the points {date_i,y_i}, with the date_i evenly spaced between the starting and ending dates from datespec.
• Irregular data {{date₁,y₁},…,{date_n,y_n}} is plotted as the ordered curve through the points {date_i,y_i} in chronological order.
• Possible forms of date_i 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 y_i can be given in the following forms:
• y_i a real-valued number
  Quantity [y_i,unit] a quantity with a unit
  Around [y_i,e_i] value y_i with uncertainty e_i
  Interval [{y_min,y_max}] values between y_min and y_max
• Values y_i that are not of the preceding form are taken to be missing and are not shown.
• The data_i have the following forms and interpretations:
• <|"k₁"y₁,"k₂"y₂,…|> values {y₁,y₂,…}
  <|date₁y₁,date₂y₂,…|> key-value pairs {{date₁,y₁},{date₂,y₂},…}
  TimeSeries , EventSeries time-value pairs
  QuantityArray magnitudes
  WeightedData unweighted values
• DateListPlot [Tabular […]cspec] extracts and plots values from the tabular object using the column specification cspec.
• The following forms of column specifications cspec are allowed for plotting tabular data:
• {col_x,col_y} plot column y against column x
  {{col_x1,col_y1},{col_x2,col_y2},…} plot column y₁ against column x₁, y₂ against x₂, …
  col_y, {col_y} plot column y as a sequence of values
  {{col_y1},…,{col_yi},…} plot columns y₁, y₂, … as sequences of values
• The col_x can also be Automatic , in which case, sequential values are generated using DataRange .
• DateListPlot [TimeSeries […]cspec] and DateListPlot [EventSeries […]cspec] extract and plot values from the time or event series using the component specification cspec.
• The following forms of component specifications cspec are allowed for plotting series data:
• com plot component com against the timestamps
  {com₁,com₂,…} plot each component com_i against the timestamps
• The following wrappers w can be used for the data_i:
• Annotation [data_i,label] provide an annotation for the data
  Button [data_i,action] define an action to execute when the points are clicked
  Callout [data_i,label] label the data with a callout
  EventHandler [data_i,…] define a general event handler for the points
  Highlighted [data_i,effect] dynamically highlight f_i with an effect
  Highlighted [data_i,Placed [effect,pos]] statically highlight f_i with an effect at position pos
  Hyperlink [data_i,uri] make the points a hyperlink
  Labeled [data_i,label] label the data
  Legended [data_i,label] identify the data in a legend
  PopupWindow [data_i,cont] attach a popup window to the points
  StatusArea [data_i,label] display in the status area on mouseover
  Style [data_i,styles] show the points using the specified styles
  Tooltip [data_i,label] attach a tooltip to the points
  Tooltip [data_i] use data values as tooltip for the points
• Wrappers w can be applied at multiple levels:
• {…,w[y_i],…} wrap the value y_i in a list
  {…,w[{date_i,y_i}],…} wrap the point {date_i,y_i}
  w[data_i] wrap the data data_i
  w[{data₁,…}] wrap a collection of data
  w₁[w₂[…]] use nested wrappers
• In DateListPlot , Labeled and Placed allow the following positions:
• Above position above curve
  Below position below curve
  Before position before curve
  After position after curve
  Start position at start of each curve
  End position at end of each curve
  x near the curve at a position x
  Scaled [s] scaled position s along the curve
  {s,Above } above relative position at position s along the curve
  {s,Below } below relative position at position s along the curve
  {pos,epos} epos in label placed at relative position pos of the curve
• DateListPlot has the same options as Graphics , with the following additions and changes: [List of all options]
• 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
  IntervalMarkers Automatic how to render uncertainties
  IntervalMarkersStyle Automatic style for uncertainty elements
  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 Automatic whether to join points
  LabelingFunction Automatic how to label points
  LabelingSize Automatic maximum size of callouts and labels
  LabelingTarget Automatic how to determine automatic label positions
  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
  PlotFit None how to fit a curve to the points
  PlotFitElements Automatic fitted elements to show in the plot
  PlotHighlighting Automatic highlighting effect for curves
  PlotInteractivity $PlotInteractivity whether to allow interactive elements
  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 {y₁,…,y_n} are interpreted into {{date₁,y₁},…,{x_n,y_n}}. Possible settings include:
• Automatic ,All uniform from 1 to n
  {x_min,x_max} uniform from x_min to x_max
• In general, a list of pairs {{x₁,y₁},{x₂,y₂},…} is interpreted as a list of points, but the setting DataRange All forces it to be interpreted as multiple data {{y₁₁,y₁₂},{y₂₁,y₂₃},…}.
• The default setting Joined Automatic draws most forms of data as joined curves, but data from EventSeries is displayed as discrete points.
• Possible settings for PlotLayout that show multiple curves in a single plot panel include:
• "Overlaid" show all the data overlapping
  "Stacked" accumulate the data
  "Percentile" accumulate and normalize the data
• Possible settings for PlotLayout that show single curves in multiple plot panels include:
• "Column" use separate curves in a column of panels
  "Row" use separate curves in a row of panels
  {"Column",k},{"Row",k} use k columns or rows
  {"Column",UpTo [k]},{"Row",UpTo [k]} use at most k columns or rows
• Typical settings for PlotLegends include:
• None no legend
  Automatic automatically determine legend
  {lbl₁,lbl₂,…} use lbl₁, lbl₂, … as legend labels
  Placed [lspec,…] specify placement for legend
• PlotStyle sty specifies the styles to use for each curve. Possible settings include:
• {sty₁,sty₂,…} sequence of styles for the datasets
  <|"key"val,…|> styling elements for different levels of data
• The accepted keys are:
• "Base" overall style for all the data_i
  "Lists" list of styles sty_i for each data_i
• ColorData ["DefaultPlotColors"] gives the default sequence of colors used by PlotStyle .
• 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.
• Possible highlighting effects for Highlighted and PlotHighlighting include:
• style highlight the indicated data
  "Ball" highlight and label the indicated point in data
  "Dropline" highlight and label the indicated point in data with droplines to the axes
  "XSlice" highlight and label all points along a vertical slice
  "YSlice" highlight and label all points along a horizontal slice
  Placed [effect,pos] statically highlight the given position pos
• Highlight position specifications pos include:
• x, {x} effect at {x,y} with y chosen automatically
  {x,y} effect at {x,y}
  {pos₁,pos₂,…} multiple positions pos_i

List of all options

Highlight options with settings specific to DateListPlot
• AlignmentPoint Center the default point in the graphic to align with
  AspectRatio 1/GoldenRatio ratio of height to width
  Axes Automatic whether to draw axes
  AxesLabel None axes labels
  AxesOrigin Automatic where axes should cross
  AxesStyle {} style specifications for the axes
  Background None background color for the plot
  BaselinePosition Automatic how to align with a surrounding text baseline
  BaseStyle {} base style specifications for the graphic
  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
  ContentSelectable Automatic whether to allow contents to be selected
  CoordinatesToolOptions Automatic detailed behavior of the coordinates tool
  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
  Epilog {} primitives rendered after the main plot
  Filling None how to fill in stems for each point
  FillingStyle Automatic style to use for filling
  FormatType TraditionalForm the default format type for text
  Frame True whether to put a frame around the plot
  FrameLabel None frame labels
  FrameStyle {} style specifications for the frame
  FrameTicks Automatic frame ticks
  FrameTicksStyle {} style specifications for frame ticks
  GridLines None grid lines to draw
  GridLinesStyle {} style specifications for grid lines
  ImageMargins 0. the margins to leave around the graphic
  ImagePadding All what extra padding to allow for labels etc.
  ImageSize Automatic the absolute size at which to render the graphic
  InterpolationOrder None the polynomial degree of curves used in joining data points
  IntervalMarkers Automatic how to render uncertainties
  IntervalMarkersStyle Automatic style for uncertainty elements
  Joined Automatic whether to join points
  LabelingFunction Automatic how to label points
  LabelingSize Automatic maximum size of callouts and labels
  LabelingTarget Automatic how to determine automatic label positions
  LabelStyle {} style specifications for 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
  PlotFit None how to fit a curve to the points
  PlotFitElements Automatic fitted elements to show in the plot
  PlotHighlighting Automatic highlighting effect for curves
  PlotInteractivity $PlotInteractivity whether to allow interactive elements
  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
  PlotRangePadding Automatic how much to pad the range of values
  PlotRegion Automatic the final display region to be filled
  PlotStyle Automatic graphics directives to determine styles of points
  PlotTheme $PlotTheme overall theme for the plot
  PreserveImageOptions Automatic whether to preserve image options when displaying new versions of the same graphic
  Prolog {} primitives rendered before the main plot
  RotateLabel True whether to rotate y labels on the frame
  ScalingFunctions None how to scale individual coordinates
  TargetUnits Automatic units to display in the plot
  Ticks Automatic axes ticks
  TicksStyle {} style specifications for axes ticks

Basic Examples  (6)

Scope  (49)

Options  (134)

Applications  (2)

Properties & Relations  (2)