DBTimestamp クラス

com.ibm.db2.jcc.DBTimestamp クラスはピコ秒までの精度とタイム・ゾーン情報を伴うタイム・スタンプ・オブジェクトを作成するために使用することができます。このクラスは主に、SQL TIMESTAMP WITH TIME ZONE データ型をサポートするためのものです。このデータ型は、現在、MySQL 5.1 でのみサポートされています。 Db2 for z/OS®。

com.ibm.db2.jcc.DBTimestamp クラスは java.sql.Timestamp クラスのサブクラスです。そのため com.ibm.db2.jcc.DBTimestamp オブジェクトは、通常 java.sql.Timestamp オブジェクトを操作する、あるいは java.sql.Timestamp オブジェクトを引数にするどんなメソッドにも使用できます。

IBM® Data Server Driver for JDBC and SQLJDBTimestamp オブジェクトを返します。 JDBC メソッドは、 ResultSet.getTimestamp や CallableStatement.getTimestamp などのタイムスタンプ情報を返します。

DBTimestamp コンストラクター

以下のコンストラクタは、 IBM Data Server Driver for JDBC and SQLJ。

DBTimestamp

形式:

public DBTimestamp(long time,
  java.util.Calendar calendar)
  throws java.sql.SQLException
public DBTimestamp(long time)
  throws java.sql.SQLException
public DBTimestamp(java.sql.Timestamp timestamp)
  throws java.sql.SQLException
public DBTimestamp(java.sql.Timestamp timestamp,
  java.util.Calendar calendar)
  throws java.sql.SQLException

DBTimestamp オブジェクトを構成します。

パラメーターの説明:

time: 1970 年 1 月 1 日からのミリ秒の数
timestamp: ピコ秒までの精度を持つ Timestamp 値。
calendar: タイム・ゾーンを提供する Calendar 値。

DBTimestamp メソッド

getPicos

形式:

public long getPicos()

DBTimestamp 値の秒構成要素の小数部分を返します。

getTimeZone

形式:

public java.util.TimeZone getTimeZone()

DBTimestamp 値のタイム・ゾーン構成要素を返します。

setPicos

フォーマット:

public void setPicos(long p)
  throws SQLException

DBTimestamp 値の秒構成要素の小数部分に、特定の値を割り当てます。

パラメーターの説明:

p: 0 以上 999999999999 以下の値で、DBTimestamp 値の構成要素の小数部分です。

setTimeZone

フォーマット:

public void setTimeZone(java.util.TimeZone timeZone)
  throws SQLException

DBTimestamp 値のタイム・ゾーン構成要素に、特定の値を割り当てます。

パラメーターの説明:

timeZone: DBTimestamp 値のタイム・ゾーン構成要素です。

valueOfDBString

フォーマット:

public static DBTimestamp valueOfDBString(String s)
  throws java.lang.IllegalArgumentException

タイム・スタンプ値のストリング表記から DBTimestamp 値を構成します。

パラメーターの説明:

s

タイム・スタンプ値のストリング表記です。値は以下の形式のいずれかである必要があります。

yyyy-mm-dd.hh.mm.ss[.ffffffffffff]-th:tm
yyyy-mm-dd hh:mm:ss[.ffffffffffff]-th:tm
yyyy-mm-dd.hh.mm.ss[.ffffffffffff]
yyyy-mm-dd hh:mm:ss[.ffffffffffff]

yyyy は年です。
mm は月です。
dd は日です。
hh は時間です。
mm は分です。
ss は秒です。
[.ffffffffffff] は 1 から 12 桁の秒の小数部分で、オプションです。
th はタイム・ゾーンの時間構成要素です。
tm はタイム・ゾーンの分構成要素です。

toDBString

フォーマット:

public String toDBString(boolean includeTimeZone)

DBTimestamp オブジェクトのストリング表記を返します。

戻り値は以下の形式のいずれかです。

yyyy-mm-dd.hh.mm.ss[.ffffffffffff]-th:tm
yyyy-mm-dd.hh.mm.ss[.ffffffffffff]

パラメーターの説明:

includeTimeZone: 戻されるストリングにタイム・ゾーン (-th:tm) を含めるかどうかを指定します。