ACIDateTimeToText()

ACIDateTimeToText()

作用：

根据指定的格式化，将一个日期句柄转换为一个日期字符串

语法：

sword ACIDateTimeToText ( void                *hndl,
                          ACIError            *err,
                          const ACIDateTime   *date,
                          const OraText       *fmt,
                          ub1                  fmt_length,
                          ub1                  fsprec,
                          const OraText       *lang_name,
                          size_t               lang_length,
                          ub4                 *buf_size,
                          OraText             *buf );

参数：

• hndl (IN)

  会话句柄或者环境句柄

• err (IN/OUT)

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

• date (IN)

  指向输入日期时间的指针

• fmt (IN)

  格式化字符串，目前不使用

• fmt_length (IN)

  格式化字符串长度，目前不使用

• fsprec (IN)

  指定秒的小数部分，其值返回的精度，目前不使用

• lang_name (IN)

  语言名字，目前不使用

• lang_length (IN)

  语言名字长度，目前不使用

• buf_size (IN/OUT)

  指向转换后字符串的长度

• buf (OUT)

  存储被转换的字符串

说明：

有关格式和多语言参数的描述，请参见中TO_DATE转换函数的描述。 转换后的以NULL终止的日期字符串存储在缓冲区buf中。

返回值：

ACI_SUCCESS; 如果err为NULL，则为ACI_INVALID_HANDLE；ACI_ERROR，如果以下任何一项为真：

• 缓冲区太小。

• 使用了无效的格式。

• 使用了未知的语言。

• 发生溢出错误。