ACIDateTimeConstruct()

ACIDateTimeConstruct()

作用：

通过输入时间参数来构造一个时间日期描述句柄

语法：

sword ACIDateTimeConstruct ( void          *hndl,
                             ACIError      *err,
                             ACIDateTime   *datetime,
                             sb2            year,
                             ub1            month,
                             ub1            day,
                             ub1            hour,
                             ub1            min,
                             ub1            sec,
                             ub4            fsec,
                             OraText       *timezone,
                             size_t         timezone_length );

参数：

• hndl (IN)

  会话句柄或者环境句柄

• err (IN/OUT)

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

• datetime (IN)

  时间日期类型的描述句柄。

• year (IN)

  输入的年份

• month (IN)

  输入的月份

• day (IN)

  输入的日份

• hour (IN)

  输入的小时

• min (IN)

  输入的分钟

• sec (IN)

  输入的秒

• fsec (IN)

  输入的纳秒数

由于神通数据库的timestamp只支持到微妙，因此fs的只必须大于等于1000，否则小数位为0.比如你想插入到数据库中2021-12-12 10:10:10.1234 ,fsec参数传入123400000

• timezone (IN)

  时区，目前不使用

• timezone_length (IN)

  时区长度，目前不使用

说明：

日期时间的类型是ACIDateTime描述符的类型。 仅使用基于类型的相关字段。 对于具有时区的类型，日期和时间字段假定为位于指定时区的本地时间。

如果未指定时区，则采用会话默认时区。

返回值：ACI_SUCCESS; 或ACI_ERROR（如果datetime无效）。