plots points with values vi at a sequence of dates.

plots points with dates at equal intervals specified by datespec.

plots the time series tseries.

plots data from all the datai.

plots datai with features defined by the symbolic wrapper w.

Details and OptionsDetails and Options

  • Possible forms of datei include:
  • DateObject,TimeObjectdate or time object
    "string"DateString specification
    {y,m,d,h,m,s}DateList specification
    {y},{y,m},{y,m,d},shortened date list
    tabsolute 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
    startdates 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:
  • via 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,}
    <|date1v1,date2v2,|>key-value pairs {{date1,v1},{date2,v2},}
    TimeSeries, EventSeriestime-value pairs
    WeightedDataunweighted 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:
  • Automaticautomatically placed labels
    Above, Below, Before, Afterpositions around the data
    datenear 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:
  • AspectRatio1/GoldenRatioratio of height to width
    AxesAutomaticwhether to draw axes
    ClippingStyleNonewhat to draw when lines are clipped
    ColorFunctionAutomatichow to determine the coloring of lines
    ColorFunctionScalingTruewhether to scale arguments to ColorFunction
    DataRangeAutomaticthe range of x values to assume for data
    DateFunctionAutomatichow to convert dates to standard form
    DateTicksFormatAutomaticformat for date tick labels
    FillingNonehow to fill in stems for each point
    FillingStyleAutomaticstyle to use for filling
    FrameTruewhether to put a frame around the plot
    InterpolationOrderNonethe polynomial degree of curves used in joining data points
    JoinedFalsewhether to join points
    MaxPlotPointsInfinitythe maximum number of points to include
    MeshNonehow many mesh points to draw on each line
    MeshFunctions{#1&}how to determine the placement of mesh points
    MeshShadingNonehow to shade regions between mesh points
    MeshStyleAutomaticthe style for mesh points
    MethodAutomaticmethods to use
    PerformanceGoal$PerformanceGoalaspects of performance to try to optimize
    PlotLabelNoneoverall label for the plot
    PlotLabelsNonelabels for data
    PlotLegendsNonelegends for datasets
    PlotMarkersNonemarkers to use to indicate each point
    PlotRangeAutomaticrange of values to include
    PlotRangeClippingTruewhether to clip at the plot range
    PlotStyleAutomaticgraphics directives to determine styles of points
    PlotTheme$PlotThemeoverall theme for the plot
    ScalingFunctionsNonehow to scale individual coordinates
    TargetUnitsAutomaticunits to display in the plot
  • DataRange determines how values {v1,,vn} are interpreted into {{date1,y1},,{xn,yn}}. Possible settings include:
  • Automatic,Alluniform 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 DataRangeAll forces it to be interpreted as multiple data {{y11,y12},{y21,y23},}.
  • Typical settings for PlotLegends include:
  • Noneno legend
    Automaticautomatically 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 and coordinates.
  • All explicit coordinates in Prolog, Epilog, Ticks, etc. are taken to be dates. »

ExamplesExamplesopen allclose all

Basic Examples  (5)Basic Examples  (5)

Plot data with explicit date values:

Click for copyable input
Click for copyable input

Plot monthly values, starting in August 2000:

Click for copyable input

Plot multiple time series with a legend:

Click for copyable input
Click for copyable input

Add labels for the data:

Click for copyable input

Retrieve and plot a historical stock price:

Click for copyable input
Introduced in 2007
| Updated in 2016