makes a timeline plot with dates date1, date2, .


makes a timeline plot with events event1, event2, .


makes a timeline plot from multiple event datasets datai.

Details and Options

  • TimelinePlot shows when events occur relative to each other.
  • 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
    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}.
  • The eventi can have the forms:
  • date1a single date or time
    Interval[{date1,date2}]a start date date1 and end date date2
    Entity[]an entity with dates according to the property "Date"
    Entity[]propan entity with dates according to the property prop
  • Datasets datai can be given in the following forms:
  • {event1,event2,}dates, times, intervals, entities, etc.
    TimeSeries[]interval with start and end dates
    EventSeries[]treat each time as an event
    {Entity[],}propentities with dates according to the property prop
    EntityClass[]entities with dates according to the property "Date"
    EntityClass[]propentities with dates according to the property prop
    <|k1event1,k2event2,|>association of keys and events
    wi[formi,]a date or event with value formi and wrapper wi
  • Possible symbolic wrappers are the same as for BarChart, and include Style, Labeled, Legended, etc.
  • TimelinePlot has the same options as Graphics with the following additions and changes:
  • AspectRatioAutomaticoverall ratio of width to height
    AxesTruewhether to draw a time axis
    AxesOriginAutomaticwhere to draw a time axis
    DateFunctionAutomatichow to convert dates to standard form
    DateTicksFormatAutomaticformat for date tick labels
    FillingAutomaticfilling to insert under each event
    FillingStyleAutomaticstyle for filling
    LabelingFunctionAutomatichow to label elements
    LegendAppearanceAutomaticoverall appearance of legends
    PerformanceGoal$PerformanceGoalaspects of performance to try to optimize
    PlotLayoutAutomaticoverall layout to use
    PlotLegendsNonelegends for datasets
    PlotMarkersNonemarkers to use to indicate each event
    PlotStyleAutomaticstyle for events
    PlotTheme$PlotThemeoverall theme for the plot
    SpacingsAutomaticspacing between datasets and axis
    TimeZone$TimeZonetime zone to use for the plot
  • Possible settings for AxesOrigin include: Left, Right, Bottom, Top, and Center.
  • Possible settings for Filling include:
  • Axisfill to the axis
    Noneno filling
    Bottomfill to the bottom of the plot
    Topfill to the top of the plot
    Abovefill to the row above
    Belowfill to the row below
  • TimelinePlot will place events in different rows. The overall placement in different rows can be affected using PlotLayout and the spacing between rows can controlled using Spacings.
  • Possible settings for PlotLayout include:
  • "Grouped"each dataset uses a minimum number of rows
    "Overlapped"each dataset uses a single row
    "Packed"use minimum number of rows for all events
    "Stacked"each event has a separate row
    "Vertical","VerticalGrouped",vertical forms of layouts
    "Reverse","ReverseVertical",reversed forms of layouts
  • Possible settings for Spacings include:
  • Automaticspace rows evenly apart
    Noneno space between rows, but space to axis
    {s1,s2,}use space s1 from axis to first row, then space s2, etc.
  • Style and other specifications from options and other constructs in TimelinePlot are effectively applied in the order PlotStyle, then Style and other wrappers, with later specifications overriding earlier ones.


open all close all

Basic Examples  (4)

Plot several dates on a timeline:

Click for copyable input

Plot date intervals:

Click for copyable input

Plot historical events:

Click for copyable input

Plot multiple sets of dates and intervals:

Click for copyable input

Scope  (33)

Options  (41)

Applications  (3)

Introduced in 2015