gettsbetweenevents

创建两次事件之间的 timeseries

语法

tsout = gettsbetweenevents(tsin,tsevent1,tsevent2)

tsout = gettsbeforeevent(tsin,tsevent1,tsevent2,n1,n2)

说明

tsout = gettsbetweenevents(tsin,tsevent1,tsevent2) 返回一个 timeseries 对象，包含在 timeseries 输入 tsin 中的事件 tsevent1 和 tsevent2 之间发生的样本。参量 tsevent1 和 tsevent2 可以是 tsdata.event 对象或包含事件名称的字符向量。如果 tsevent1 和 tsevent2 是 tsdata.event 对象，则由这两个事件定义的时间来指定时间。如果 tsevent1 和 tsevent2 是字符向量，则由 tsin 的 Events 属性中与事件名称匹配的第一个 tsdata.event 对象来指定时间。

tsout = gettsbeforeevent(tsin,tsevent1,tsevent2,n1,n2) 返回一个 timeseries 对象，包含在 tsin 中的两个事件之间发生的样本，其中 n1 是事件 tsevent1 的发生次数，n2 是事件 tsevent2 的发生次数。

示例

全部折叠

两个事件之间的 `timeseries`

打开实时脚本

创建一个 timeseries 对象，其中包含在时间样本 1 和 3 时发生的事件。

tsin = timeseries((1:5)');
tsevent1 = tsdata.event('StartEvent',1);
tsevent2 = tsdata.event('EndEvent',3);
tsin = addevent(tsin,[tsevent1 tsevent2]);

创建一个新的 timeseries 对象，其中包含这两个事件样本之间的数据。

tsout = gettsbetweenevents(tsin,'StartEvent','EndEvent');
tsout.Time

输入参数

全部折叠

`tsin` — 输入 `timeseries`
标量

输入 timeseries，指定为标量。

数据类型: timeseries

`tsevent1` — 开始事件
标量 | 字符向量

开始事件，指定为标量 tsdata.event 对象或包含事件名称的字符向量。

`tsevent2` — 结束事件
标量 | 字符向量

结束事件，指定为标量 tsdata.event 对象或包含事件名称的字符向量。

`n1` — 开始事件编号
整数标量

开始事件编号，指定为与 timeseries 对象的第 n1 个 tsdata.event 对应的整数标量。

`n2` — 结束事件编号
整数标量

结束事件编号，指定为与 timeseries 对象的第 n2 个 tsdata.event 对应的整数标量。

提示

当 timeseries 对象输入 tsin 包含日期字符向量而 tsevent1 和 tsevent2 使用数值时间时，所选时间被视为是相对于 tsin.TimeInfo 中的 StartDate 属性计算的日期。
当 tsin 使用数值时间而 tsevent1 和 tsevent2 使用日历日期时，所选时间被视为是与日历日期没有关联的数值。