ts_elem() 函数

ts_elem() 函数从给定时间的时间系列返回元素。

语法

ts_tselem 
ts_elem(ts_tsdesc   *tsdesc, 
         mi_datetime *tstamp, 
         mi_integer  *STATUS, 
         mi_integer  *off)

tsdesc

ts_open() 返回的时间系列描述符。

tstamp

所需元素的时间戳记的指针。

STATUS

返回时设置为指示元素是 NULL 还是被隐藏。有关 isNull 参数的说明，请参阅 ts_hide_elem() 函数。

off

对于规则时间系列，off 在返回时设置为偏移量。如果时间系列不规则，或者如果时间戳记不在日历中，那么 off 将设置为 -1。偏移量可以是 NULL。

描述

返回时，对于规则时间系列，off 将填入元素的偏移量；对于不规则时间系列，将填入 -1。在使用此 tsdesc（时间系列描述符）访存元素的两次调用后将会覆盖该元素。

等效 SQL 函数是 GetElem。

返回结果

一个元素、其偏移量以及以及该元素是被隐藏、为 NULL 还是同时处于这两种状态。该元素不得由调用者释放。