Documentation

getabstime

Class: timeseries

Extract date-string time vector into cell array

Syntax

getabstime(ts)

Description

getabstime(ts) extracts the time vector from the timeseries object ts as a cell array of date strings.

Tips

  • To define the time vector relative to a calendar date, set the TimeInfo.StartDate property of the timeseries object. When the TimeInfo.StartDate format is a valid datestr format, the output strings from getabstime have the same format.

Input Arguments

ts

The timeseries object from which you want to extract the time vector.

Examples

The following example extracts a time vector as a cell array of date strings from a timeseries object.

First, create a timeseries object.

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

The default time vector for ts is [0 1 2 3 4], which starts at 0 and increases in 1-second increments. The length of the time vector is equal to the length of the data.

Next, set the StartDate property.

ts.TimeInfo.StartDate = '10/27/2005 07:05:36';

Extract the time vector.

getabstime(ts)

MATLAB® returns:

'27-Oct-2005 07:05:36'
'27-Oct-2005 07:05:37'
'27-Oct-2005 07:05:38'
'27-Oct-2005 07:05:39'
'27-Oct-2005 07:05:40'

Change the date-string format of the time vector, and then extract the time vector with the new date-string format:

ts.TimeInfo.Format = 'mm/dd/yy';
getabstime(ts)

MATLAB returns:

'10/27/05'
'10/27/05'
'10/27/05'
'10/27/05'
'10/27/05'
Was this topic helpful?