java.sql
クラス Timestamp

java.lang.Object
  |
  +--java.util.Date
        |
        +--java.sql.Timestamp

すべての実装インタフェース:

Cloneable, Comparable, Serializable

public class Timestamp

extends Date

このクラスは、java.util.Date の thin ラッパーで、このラッパーによって JDBC API はこれを SQL TIMESTAMP 値として識別できます。このクラスは、SQL TIMESTAMP の nanos 値 (ナノ秒の値) を保持する機能を追加し、タイムスタンプ値の JDBC エスケープ構文をサポートするためのフォーマットと構文解析操作を提供します。

注: この型は java.util.Date と各ナノ秒値からなります。秒の整数値だけが java.util.Date の構成要素内に格納され、小数点以下の秒 (秒の nanos 値) は別の構成要素内に格納されます。getTime メソッドは、秒の整数値だけを返します。小数点以下の秒を含む時間値が必要な場合は、秒の nanos 値をミリ秒 (1000000 分の nanos) に変換し getTime 値に加える必要があります。Timestamp.equals(Object) メソッドは、java.util.Date 型の値が渡された場合は true を返しません。その理由は、日付の nanos 構成要素が不明だからです。そのため、Timestamp.equals(Object) メソッドは java.util.Date.equals(Object) メソッドと対称ではありません。また、hashcode メソッドは、基本となる java.util.Data 実装を使用するので、計算には nanos 値を含めません。 上記のような Timestamp クラスと java.util.Date クラスの違いのため、Timestamp 値は java.util.Date のインスタンスとして考えないでください。Timestamp と java.util.Date の継承関係は、型の継承ではなく、実装の継承を示します。

関連項目:

直列化された形式

コンストラクタの概要

Timestamp(int year, int month, int date, int hour, int minute, int second, int nano)
推奨されていません。 Timestamp(long millis) コンストラクタを代わりに使用してください。

Timestamp(long time)
ミリ秒の値を使用して、Timestamp オブジェクトを構築します。

メソッドの概要

boolean	after(Timestamp ts) この Timestamp オブジェクトが、指定された Timestamp オブジェクトより遅い時刻かどうかを示します。
boolean	before(Timestamp ts) この Timestamp オブジェクトが、指定された Timestamp オブジェクトより早い時刻かどうかを示します。
boolean	equals(Object ts) この Timestamp オブジェクトが指定されたオブジェクトと等しいかどうかを判定します。
boolean	equals(Timestamp ts) この Timestamp オブジェクトと指定された Timestamp オブジェクトが等しいかどうかを判定します。
int	getNanos() この Timestamp オブジェクトの nanos 値を取得します。
void	setNanos(int n) この Timestamp オブジェクトの nanos フィールドを指定された値に設定します。
String	toString() タイムスタンプを JDBC タイムスタンプエスケープ形式にフォーマットします。
static Timestamp	valueOf(String s) JDBC タイムスタンプエスケープ形式の String オブジェクトを Timestamp 値に変換します。

クラス java.util.Date から継承したメソッド

after, before, clone, compareTo, compareTo, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTime, getTimezoneOffset, getYear, hashCode, parse, setDate, setHours, setMinutes, setMonth, setSeconds, setTime, setYear, toGMTString, toLocaleString, UTC

クラス java.lang.Object から継承したメソッド

finalize, getClass, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

Timestamp

public Timestamp(int year,
                 int month,
                 int date,
                 int hour,
                 int minute,
                 int second,
                 int nano)

推奨されていません。 Timestamp(long millis) コンストラクタを代わりに使用してください。

指定された値で初期化された Timestamp オブジェクトを構築します。

パラメータ:

year - 年数 - 1900 (年数から 1900 を引いた値)

month - 0 〜 11

date - 1 〜 31

hour - 0 〜 23

minute - 0 〜 59

second - 0 〜 59

nano - 0 〜 999,999,999

Timestamp

public Timestamp(long time)

ミリ秒の値を使用して、Timestamp オブジェクトを構築します。整数値の秒は date 値に格納され、小数点以下の秒数は Timestamp オブジェクトの nanos フィールドに格納されます。

パラメータ:

time - 1970 年 1 月 1 日、0 時 0 分 0 秒 GMT (グリニッジ標準時) を起点とした時間をミリ秒で表した値。負の値は、1970 年 1 月 1 日、0 時 0 分 0 秒 GMT (グリニッジ標準時) より前のミリ秒

メソッドの詳細

valueOf

public static Timestamp valueOf(String s)

JDBC タイムスタンプエスケープ形式の String オブジェクトを Timestamp 値に変換します。

パラメータ:

s - yyyy-mm-dd hh:mm:ss.fffffffff 形式のタイムスタンプ

戻り値:

対応する Timestamp 値

例外:

IllegalArgumentException - 指定された引数が yyyy-mm-dd hh:mm:ss.fffffffff 形式ではない場合

toString

public String toString()

タイムスタンプを JDBC タイムスタンプエスケープ形式にフォーマットします。

オーバーライド:

クラス Date 内の toString

戻り値:

yyyy-mm-dd hh:mm:ss.fffffffff 形式の String オブジェクト

getNanos

public int getNanos()

この Timestamp オブジェクトの nanos 値を取得します。

戻り値:

この Timestamp オブジェクトの小数点以下の秒の構成要素

setNanos

public void setNanos(int n)

この Timestamp オブジェクトの nanos フィールドを指定された値に設定します。

パラメータ:

n - 新しい小数点以下の秒の構成要素

例外:

IllegalArgumentException - 指定された引数が 999999999 より大きいか、0 より小さい場合

equals

public boolean equals(Timestamp ts)

この Timestamp オブジェクトと指定された Timestamp オブジェクトが等しいかどうかを判定します。

パラメータ:

ts - 比較対象の Timestamp 値

equals

public boolean equals(Object ts)

この Timestamp オブジェクトが指定されたオブジェクトと等しいかどうかを判定します。 このバージョンの equals メソッドは、Timestamp.equals(Timestamp) の正しくないシグニチャーの修正と、既存のクラスファイルとの下位互換を保持するために追加されました。 注: このメソッドは、基底クラスの equals(Object) メソッドと対称ではありません。

オーバーライド:

クラス Date 内の equals

パラメータ:

ts - 比較対象の Object 値

before

public boolean before(Timestamp ts)

この Timestamp オブジェクトが、指定された Timestamp オブジェクトより早い時刻かどうかを示します。

パラメータ:

ts - 比較対象の Timestamp 値

戻り値:

この Timestamp オブジェクトの方が早い場合は true、そうでない場合は false

after

public boolean after(Timestamp ts)

この Timestamp オブジェクトが、指定された Timestamp オブジェクトより遅い時刻かどうかを示します。

パラメータ:

ts - 比較対象の Timestamp 値

戻り値:

この Timestamp オブジェクトの方が遅い場合は true、そうでない場合は false