HideElem 函数

HideElem 函数将给定时间戳记的元素或元素集标记为不可见。

语法

HideElem(ts     TimeSeries, 
        tstamp datetime year to fraction(5),
        flags  integer default 0) 
returns TimeSeries;

HideElem(ts         TimeSeries, 
       multiset_tstamps multiset(datetime year to fraction(5) not null),
        flags       integer default 0) 
returns TimeSeries;

ts: 源时间系列。
tstamp: 使元素不可见的时间戳记。
multiset_tstamps: 使元素不可见的时间戳记的多集。
flags: flags 参数值中描述了 flags 参数的有效值。缺省值为 0。

描述

元素隐藏后，读取该元素将返回 NULL，写入该元素将导致错误消息。但是，可以使用 ts_begin_scan() 来读取隐藏的元素。

与此函数等效的 API 为 ts_hide_elem()。

如果时间戳记不是时间系列中的有效时间点，那么将出现错误。

返回结果

修改的时间系列。

示例

以下示例隐藏 GBase 8s 的时间系列中 2011-01-03 的元素：

select HideElem(stock_data, '2011-01-03 00:00:00.00000')
   from daily_stocks
   where stock_name = 'GBase';