ClipGetCount 函数

ClipGetCount 函数返回当前时间系列中在使用时间戳记定界的时间段中产生的元素数。

语法

ClipGetCount(ts TimeSeries, 
       begin_stamp datetime year to fraction(5) default NULL, 
       end_stamp   datetime year to fraction(5) default NULL,
        flags       integer default 0) 
returns integer;

ts: 源时间系列。
begin_stamp: 范围的起始点。可为 NULL。
end_stamp: 范围的结束点。可为 NULL。
flags: flags 参数的有效值将在本主题的后面部分加以说明。

描述

对于不规则的时间系列，不对删除的元素进行计数。对于规则的时间系列，仅对非空条目进行计数，因此 ClipGetCount 可能返回与 GetNelems 不同的值。

如果起始点为 NULL，那么将使用时间系列原点。如果结束点为 NULL，那么将使用时间系列的结尾。

请参阅 Clip 函数以获取有关范围起始点和结束点的更多信息。

flags 自变量值

flags 参数决定了扫描应如何处理返回的集合。如果将 flags 参数设置为 0（缺省值），那么空元素和隐藏的元素不属于计数范围。如果 flags 参数的值为 512 (0x200)（设置为 TS_SCAN_HIDDEN 位），那么将对无论是隐藏还是未隐藏的所有非空元素进行计数。

标志	值	含义
TSOPEN_RDWRITE	0	（缺省值）隐藏的元素不包括在计数中。
TS_SCAN_HIDDEN	512	通过 HideElem 标记的隐藏元素包括在计数中（请参阅 HideElem 函数）。

返回结果

给定时间系列中在使用时间戳记定界的时间段中产生的元素数。

示例

以下语句返回 2011 年 3 月 14 日上午 10:30 和 2011 年 3 月 19 日午夜（包含这两个时间点）之间的元素数：

select ClipGetCount(activity_data,
   '2011-03-14 10:30:00.00000','2011-03-19 00:00:00.00000')
    from activity_stocks
    where stock_id = 600;