getsampleusingtime

timeseries 或 tscollection 数据的子集

全页折叠

语法

tsout = getsampleusingtime(tsin,timeval)
tsout = getsampleusingtime(tsin,timeval,'AllowDuplicateTimes',true)
tsout = getsampleusingtime(tsin,starttime,endtime)

说明

tsout = getsampleusingtime(tsin,timeval) 返回与时间 timeval 对应的输入 timeseries 或 tscollection 的单个数据样本。tsout 与 tsin 具有相同的对象类型。

tsout = getsampleusingtime(tsin,timeval,'AllowDuplicateTimes',true) 包含具有 timeval 所指定时间值的多个数据样本。

tsout = getsampleusingtime(tsin,starttime,endtime) 包含 tsin 在时间 starttime 和 endtime 之间的样本。

示例

示例

全部折叠

打开实时脚本

创建一个 timeseries 对象，并提取与第 2 个到第 4 个时间值对应的数据样本。

tsin = timeseries((1:5)',1:5);
tsout = getsampleusingtime(tsin,2,4);
tsout.Data
ans = 3×1

     2
     3
     4
打开实时脚本

使用两个 timeseries 对象创建一个 tscollection 对象，并提取与第 2 个到第 4 个时间值对应的数据样本。

ts1 = timeseries(rand(5,1),'Name','ts1');
ts2 = timeseries(rand(5,1),'Name','ts2');
tscin = tscollection({ts1,ts2});

tscout = getsampleusingtime(tscin,2,4);
tscout.Time
ans = 3×1

     2
     3
     4

输入参数

全部折叠

输入时间序列，指定为 timeseries 或 tscollection 对象。

采样时间，指定为数值标量、日期字符向量或 datenum 标量。有效日期字符向量可以采用以下格式：

格式示例
dd-mmm-yyyy HH:MM:SS01-Mar-2000 15:45:17
dd-mmm-yyyy01-Mar-2000
mm/dd/yy03/01/00
mm/dd03/01
HH:MM:SS15:45:17
HH:MM:SS PM3:45:17 PM
HH:MM15:45
HH:MM PM3:45 PM
mmm.dd,yyyy HH:MM:SSMar.01,2000 15:45:17
mmm.dd,yyyyMar.01,2000
mm/dd/yyyy03/01/2000

数据类型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | cell

开始时间，指定为数值标量、日期字符向量或 datenum 标量。

结束时间，指定为数值标量、日期字符向量或 datenum 标量。

提示

  • 如果 tsin 中的时间向量不是相对于日历日期，则 starttime 和 endtime 必须是数值。

  • 如果 tsin 中的时间向量相对于日历日期，则 starttime 和 endtime 值必须是日期字符向量或 datenum 值。

版本历史记录

在 R2006a 之前推出

另请参阅

|