represents a time series specified by time-value pairs {ti,vi}.


represents a time series with values vi at times specified by tspec.

Details and Options

  • TimeSeries represents a series of time-value pairs {ti,vi}.
  • The values vi can be scalars or arrays of any dimension, but must all be of equal dimensionality.
  • The following times tspec can be given:
  • Automaticuse uniformly spaced times starting at 0
    {tmin}use uniformly spaced times starting at tmin
    {tmin,tmax}use uniformly spaced times tmin to tmax
    {tmin,tmax,dt}use times tmin to tmax in steps of dt
    {{t1,t2,}}use explicit times {t1,t2,}
  • The ti can be numbers or any valid input to AbsoluteTime.
  • The values tmin, tmax, and dt can be given as numbers, dates, or Automatic.
  • Specifying ts[t] gives the value of the time series at time t.
  • TimeSeries is a special case of TemporalData allowing only a single path.
  • TimeSeries objects of equal dimensionality {ts1,ts2,} can be combined into a TemporalData object using TemporalData[{ts1,ts2,}].
  • Properties of a TimeSeries object ts can be obtained from ts["property"].
  • A list of available properties can be obtained using ts["Properties"].
  • Some properties of the time series include:
  • "Path"time-value pairs {{t1,v1},}
    "PathFunction"an interpolated path function
    "PathLength"the length of the path
    "Values"the values {v1,}
    "ValueDimensions"the dimensionality of the vi
    "Times"the times {t1,}
    "Dates"the times {t1,} as dates
    "DatePath"date-value pairs {{date1,v1},}
    "FirstTime"the first time t1
    "FirstDate"the first time t1 as date
    "LastTime"the last time
    "LastDate"the last time as date
    "FirstValue"the value v1 at the first time
    "LastValue"the value at the last time
  • If dates are given as input, ts["Times"] returns them in AbsoluteTime.
  • Normal[ts] is equivalent to ts["Path"].
  • TimeSeries takes the following options:
  • CalendarType"Gregorian"the calendar type to use
    HolidayCalendar{"UnitedStates","Default"}the holiday calendar to use
    MetaInformationNoneinclude additional meta-information
    MissingDataMethodNonemethod to use for missing values
    ResamplingMethod"Interpolation"the method to use for resampling paths
    TemporalRegularityAutomaticwhether to assume the data is regular
    DateFunctionAutomatichow to convert dates to standard form
  • By default, first-order interpolation is used for resampling. The setting ResamplingMethod->{"Interpolation",opts} can be given, where opts are options passed to Interpolation.
  • Setting the MissingDataMethod->Automatic will automatically interpolate values with head Missing according to the ResamplingMethod setting. By default, values with head Missing are treated as missing.


open all close all

Basic Examples  (2)

Create a time series from some values and times:

Click for copyable input
Click for copyable input

Visualize the path:

Click for copyable input

Use dates as time stamps:

Click for copyable input

Plot the time series with DateListPlot:

Click for copyable input

The value of the stock on May 24, 2009:

Click for copyable input

The average value of the stock over the date range:

Click for copyable input

Scope  (32)

Options  (10)

Applications  (14)

Properties & Relations  (3)

Possible Issues  (2)

Neat Examples  (1)

Introduced in 2014
Updated in 2015