DelRange 函数

DelRange 函数删除指定时间系列实例中指定时间范围(包括定界时间点)内的所有元素。DelRange 函数与 DelTrim 函数相似,但不同的是 DelRange 函数删除元素并从规则时间系列的任何部分回收空间。

语法

DelRange(ts          TimeSeries, 
       begin_stamp datetime year to fraction(5), 
       end_stamp   datetime year to fraction(5),
       flags       integer default 0) 
returns TimeSeries;
ts
要对其执行操作的时间系列。
begin_stamp
范围的起始点。
end_stamp
范围的结束点。
flags
flags 参数值中描述了 flags 参数的有效值。缺省值为 0

描述

使用 DelRange 函数可删除时间系列实例中指定时间范围内的元素并释放生成的任何空页面。例如,可以从时间系列实例的起点除去数据,以便对这些数据进行归档。

如果使用 DelRange 函数来删除隐藏的元素,或者如果范围的起始点早于时间系列的原点,那么将发生错误。

返回结果

其在指定时间点之间范围内的所有元素已被删除的时间系列。

示例

以下示例将除去指定时间系列实例在指定日期的一天范围中的所有元素:
UPDATE ts_data
SET meter_data = DelRange(meter_data,
        '2010-11-11 00:00:00.00000'
     ::datetime year to fraction(5),
        '2010-11-11 00:00:00.00000'
     ::datetime year to fraction(5))
WHERE loc_esi_id = 4727354321000111;