getabstime

Convert timeseries or tscollection time vector to cell array

Syntax

tstime = getabstime(ts)

Description

tstime = getabstime(ts) returns a cell array whose elements are the dates in the time vector associated with the time series in ts. The property ts.TimeInfo.StartDate must represent a date as a character vector.

Examples

Cell Array of Time Vector Elements

Extract time values in a timeseries time vector as a cell array of dates and times.

Create a timeseries object with the default time vector [0 1 2 3 4].

ts = timeseries([3 6 8 0 10]);

Set the TimeInfo.StartDate property to a date character vector and display the new times associated with ts, which are in increments of 1 second.

ts.TimeInfo.StartDate = '10/27/2005';
tstime = getabstime(ts)

tstime = 5×1 cell
    {'27-Oct-2005 00:00:00'}
    {'27-Oct-2005 00:00:01'}
    {'27-Oct-2005 00:00:02'}
    {'27-Oct-2005 00:00:03'}
    {'27-Oct-2005 00:00:04'}

Input Arguments

ts — Input time series

timeseries object | tscollection object

Input time series, specified as a timeseries or tscollection object.

Tips

• To define the timeseries time vector relative to a calendar date, set the TimeInfo.StartDate property to a valid date character vector. Valid dates can have the following formats:

  Format	Example
  dd-mmm-yyyy HH:MM:SS	01-Mar-2000 15:45:17
  dd-mmm-yyyy	01-Mar-2000
  mm/dd/yy	03/01/00
  mm/dd	03/01
  HH:MM:SS	15:45:17
  HH:MM:SS PM	3:45:17 PM
  HH:MM	15:45
  HH:MM PM	3:45 PM
  mmm.dd,yyyy HH:MM:SS	Mar.01,2000 15:45:17
  mmm.dd,yyyy	Mar.01,2000
  mm/dd/yyyy	03/01/2000

Version History

Introduced before R2006a