19.5.2 a_rdb_CNV_charDATE()(DATE型データへの変換)
(1) 機能
C言語またはC++言語の文字列データをSQLのDATE型のデータに変換します。文字列データをDATE型のデータに変換する場合の例を次の図に示します。
- 重要
-
変換前の文字列データは,日付を表す既定の入力表現に従った形式にしておく必要があります。日付を表す既定の入力表現については,マニュアルHADB SQLリファレンスの既定の文字列表現を参照してください。
- (例)
-
2014年9月30日を表す場合,文字列データは次のどちらかの形式である必要があります。
2014-09-30
2014/09/30
(2) 形式
#include <adbcnv.h> signed short a_rdb_CNV_charDATE ( char *char_Data, /* In */ unsigned char *DATE_Data, /* Out */ unsigned short BufferLength, /* In */ void *Option /* In */ )
(3) 引数の説明
- char_Data:
-
変換前の文字列データ(C言語またはC++言語の文字列データ)を格納している領域の先頭アドレスを指定します。
- DATE_Data:
-
変換後のDATE型のデータを格納する領域の先頭アドレスを指定します。
- BufferLength:
-
変換後のDATE型のデータを格納する領域の長さをバイト数で指定します。4を指定してください。
- Option:
-
NULLを指定します。
(4) 戻り値
-
a_rdb_CNV_charDATE()が正常に終了した場合,a_rdb_RC_CNV_SUCCESSが返却されます。
-
エラーが発生した場合,戻り値にエラーコードが返却されます。エラーコードについては,「19.8 CLI関数の戻り値」を参照してください。
(5) 留意事項
変換前のデータ格納領域(char_Data)と,変換後のデータ格納領域(DATE_Data)は重複しないようにしてください。