GetElem 函数

语法

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

ts

源时间系列。

tstamp

条目的时间戳记。

flags

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

描述

如果时间戳记的时间不在日历范围内，或者如果早于给定时间系列的原点，那么将返回 NULL。在某些情况下，GetLastValid、GetNextValid 或 GetPreviousValid 可能更为适当。

对于规则的时间系列，抽取的数据与包含时间戳记的时间段关联。例如，如果时间系列设置为上午 8:00 到下午 5:00 每小时，时间戳记为下午 3:15，那么将返回下午 3:00 和与该时间关联的数据。

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

返回结果

包含时间戳记和时间系列中该时间戳记的数据的行类型。该行的类型与时间系列子类型相同。

示例

select GetElem(stock_data,'2011-01-04 00:00:00.00000')
   from daily_stocks
   where stock_name = 'GBase' or stock_name = 'HWP';