8.6.27　getDate(int columnIndex)

(1)　機能

ResultSetオブジェクトの現在行の列の値をjava.sql.Dateオブジェクトに取得します。値を取得する列は，引数で指定します。

ページの先頭へ

(2)　形式

public synchronized java.sql.Date getDate(int columnIndex) throws SQLException

ページの先頭へ

(3)　引数

int columnIndex：

列番号を指定します。

ページの先頭へ

(4)　戻り値

列値を格納したjava.sql.Dateオブジェクトが返却されます。検索結果と戻り値の関係を次の表に示します。

DATE型，TIME型，TIMESTAMP型，または文字列型（CHAR，VARCHAR）の変換については，「7.6.2　データの変換処理」の「(2)　getXXXメソッド実行時のデータ変換処理（DATE型，TIME型，TIMESTAMP型，または文字列型の場合）」を参照してください。

表8‒31　検索結果と戻り値の関係（getDateメソッドの場合）

HADBのデータ型	検索結果	戻り値
CHAR VARCHAR	ナル値	null
	[半角空白]日付形式※[半角空白]	検索結果の前後の半角空白を取り除きjava.sql.Dateオブジェクトにしたもの
	上記以外	SQLExceptionが投入される
DATE	ナル値	null
	上記以外	検索結果をjava.sql.Dateオブジェクトにしたもの
TIME	ナル値	null
	上記以外	検索結果をjava.sql.Dateオブジェクトにしたもの
TIMESTAMP	ナル値	null
	上記以外	検索結果をjava.sql.Dateオブジェクトにしたもの
そのほか	該当しません	SQLExceptionが投入される

注※

日付形式とは，'YYYY-MM-DD'で表される文字列表現のことです。

ページの先頭へ

(5)　発生する例外

次に示す場合にSQLExceptionが投入されます。

• このResultSetオブジェクトがクローズされている場合

  このResultSetオブジェクトを生成したStatementオブジェクトがクローズされたことによって，ResultSetオブジェクトがクローズされた場合も含みます。

• このResultSetオブジェクトを生成したStatementオブジェクトを作成したConnectionがクローズされている場合

• トランザクションの決着によってResultSetオブジェクトが無効になった場合

• 存在しない列番号を指定した場合

• このメソッドでは取得できないデータ型の場合

• 列の値がjava.sql.Dateとして取得できない場合

• JDBCドライバ内でエラーが発生した場合

ページの先頭へ