ACIIntervalToText()

ACIIntervalToText()

作用：

将给定的时间间隔描述句柄转换为一个字符串

语法：

sword ACIIntervalToText ( void               *hndl,
                          ACIError           *err,
                          const ACIInterval  *interval,
                          ub1                 lfprec,
                          ub1                 fsprec,
                          OraText            *buffer,
                          size_t              buflen,
                          size_t             *resultlen );

参数：

• hndl (IN)

会话句柄或者环境句柄

• err (IN/OUT)

错误句柄，该接口调用失败时，错误信息会存在该句柄上 ，调用 ACIErrorGet 获得错误信息。

• interval (IN)

待转换的时间间隔描述句柄

• lfprec (IN)

主区域的精度。对于interval year [(p)] to month类型，该参数表示p;对于interval day[(p)] to second[(q)] 类型，该参数表示p。

• fsprec (IN)

第二区域的精度。对于interval year [(p)] to month类型该参数无效；对于interval day[(p)] to second[(q)] 类型，该参数表示q。

• buffer (OUT)

转换后得到的字符串

• buflen (IN)

buffer的长度，以字节为单位。

• resultlen (OUT)

存放到buffer中的字符串长度，以字节为单位。

说明：

间隔文字以INTERVAL YEAR TO MONTH间隔的“year”或“ [year-]month”输出，并以“second”或“minutes [:second]”或“hours[：minutes [：second]]”或“ days [hours [：minutes [：seconds]]]]间隔为INTERVAL DAY TO SECOND个间隔（其中可选字段用方括号括起来）。

返回值：ACI_SUCCESS; 如果err是NULL指针，则为ACI_INVALID_HANDLE；

ACI_ERROR，如果缓冲区的大小不足以容纳结果。