Date类型接口

TO_DATE中fmt支持的格式

OCIDateSysDate

功能描述

获取客户端当前系统的时间和日期。

功能说明

获取客户端当前系统的时间和日期。

接口信息

函数/过程

OCIDateSysDate语法如下：

sword OCIDateSysDate( 
                    OCIError     *errhp, 
                    OCIDate        *sys_date
 )

具体参数解释如下：

• errhp(IN)：错误句柄，当出现错误时，使用OCIErrorGet()获取错误信息。
• sya_date(OUT)：客户端当前的时间和日期，不能为空。

其他说明

无

OCIDateToText

功能描述

将日期类型转换为字符串。

功能说明

将日期类型转换成字符串。

接口信息

函数/过程

OCIDateToText语法如下：

sword OCIDateToText ( 
OCIError                  *err, 
                        const OCIDate             *date, 
                        const OraText             *fmt, 
                        ub1                        fmt_length, 
                        const OraText             *lang_name,
                        ub4                        lang_length, 
                        ub4                       *buf_size, 
                        OraText                   *buf 
)

参数的解释如下：

• err(IN)：错误句柄，可以通过OCIErrorGet()诊断错误信息。
• date(IN):要装换的OCIDate类型的日期。
• fmt(IN):转换成的格式。如果为NULL、（text*）0，则日期将装换成默认格式“DD-MON-YY”的字符串
  • 目前只支持“dd”表示日，“mm”表示月，“yyyy”表示年，“hh”表示时，“mi”表示分，“ss”表示秒，但是字段顺序没有要求，字段分隔符也没有要求。例如：“ddmmyyyy:hhmiss”或者“dd mm yyyy:hh mi ss”。
  • 目前暂不支持为NULL使用默认的情况。
  • 目前年份暂时不考虑为负数的情况。
• fmt_length(IN):fmt的长度。
• lang_name(IN):指定返回月份和日期的名称的缩写的语言；lang_name如果为NULL、（text*）则会使用默认语言。目前暂不支持指定。
• leng_length(IN):lang_name的长度，目前暂不支持指定。
• buf_size(IN/OUT):输入缓冲区的大小，输出字符串的大小。
• buf(out):转换成字符串后所在的缓冲区，不能为空。

其他说明

无

OCIDateFromText

功能描述

根据指定格式的字符串转换成日期类型。

功能说明

根据给定的字符串以及字符串格式，将字符串转换成日期时间类型。

接口信息

函数/过程

OCIDateFromText语法如下：

sword OCIDateFromText( 
OCIError           *err,
const OraText      *date_str, 
ub4                 d_str_length, 
const OraText      *fmt,
 ub1                 fmt_length, 
const OraText      *lang_name,
ub4                 lang_length, 
                        OCIDate            *date 
)

参数的解释如下：

• err(IN)：错误句柄，可以通过OCIErrorGet()诊断错误信息。
• date_str(IN)：要转换成日期类型的字符串。
• d_str_length(IN)：输入的字符串长度。如果为-1，则将date_str视为以NULL结尾的字符串。
• fmt(IN):字符串的格式，如果fmt是NULL指针，则字符默认为“DD-MON-YY”格式
  • 目前只支持“dd”表示日，“mm”表示月，“yyyy”表示年。但是字段顺序没有要求，字段分隔符也没有要求。例如：“ddmmyyyy”或者“dd mm yyyy”。
  • 目前暂不支持为NULL使用默认的情况。
• fmt_length(IN)：fmt的长度。
• leng_name(IN)：指定日期和月份的名称和缩写的语言，如果lang_name是NULL、（text*）0，则使用默认语言。
• lang_length(IN)：lang_name的长度。
• date(IN)：结果的日期类型指针，不能为空。

其他说明

无