GetNextValid 函数

语法

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

ts

源时间系列。

tstamp

条目的时间戳记。

flags

flags 参数值中描述了 flags 参数的有效值。缺省值为 0。

描述

对于规则的时间系列，GetNextValid 返回在给定时间戳记之后的日历最早有效时间点的元素。对于不规则的时间系列，将返回给定时间戳记之后的最早元素。

等效的 API 函数为 ts_next_valid()。

返回结果

包含给定时间戳记之后的最近元素的行类型。该行的类型与时间系列子类型相同。

如果时间戳记晚于时间系列中的最后一个时间戳记，那么将返回 NULL。

示例

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

select GetNextValid(activity_data, 
   '2011-01-03 00:00:00.00000')
   from activity_stocks
   where stock_id = 600;