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 オブジェクトより早い時刻かどうかを示します。
int	compareTo(Object o) この Timestamp を別の Object と比較します。
int	compareTo(Timestamp ts) 順序付けのために 2 つの Timestamp を比較します。
boolean	equals(Object ts) この Timestamp オブジェクトが指定されたオブジェクトと等しいかどうかを判定します。
boolean	equals(Timestamp ts) この Timestamp オブジェクトと指定された Timestamp オブジェクトが等しいかどうかを判定します。
int	getNanos() この Timestamp オブジェクトの nanos 値を取得します。
long	getTime() Timestamp オブジェクトで表される、1970 年 1 月 1 日、0 時 0 分 0 秒 GMT (グリニッジ標準時) からのミリ秒数を返します。
void	setNanos(int n) この Timestamp オブジェクトの nanos フィールドを指定された値に設定します。
void	setTime(long time) この Timestamp オブジェクトを、1970 年 1 月 1 日、0 時 0 分 0 秒 GMT (グリニッジ標準時) から time ミリ秒の時点を表すように設定します。
String	toString() タイムスタンプを JDBC タイムスタンプエスケープ形式にフォーマットします。
static Timestamp	valueOf(String s) JDBC タイムスタンプエスケープ形式の String オブジェクトを Timestamp 値に変換します。

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

after, before, clone, compareTo, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTimezoneOffset, getYear, hashCode, parse, setDate, setHours, setMinutes, setMonth, setSeconds, 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 を引いたもの

month - 0 〜 11

date - 1 〜 31

hour - 0 〜 23

minute - 0 〜 59

second - 0 〜 59

nano - 0 〜 999,999,999

例外:

IllegalArgumentException - nano 引数が範囲外にある場合

Timestamp

public Timestamp(long time)

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

パラメータ:

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

関連項目:

for more information

メソッドの詳細

setTime

public void setTime(long time)

この Timestamp オブジェクトを、1970 年 1 月 1 日、0 時 0 分 0 秒 GMT (グリニッジ標準時) から time ミリ秒の時点を表すように設定します。

オーバーライド:

クラス Date 内の setTime

パラメータ:

time - ミリ秒数

関連項目:

getTime(), Timestamp(long time), for more information

getTime

public long getTime()

Timestamp オブジェクトで表される、1970 年 1 月 1 日、0 時 0 分 0 秒 GMT (グリニッジ標準時) からのミリ秒数を返します。

オーバーライド:

クラス Date 内の getTime

戻り値:

この日付で表される、1970 年 1 月 1 日、0 時 0 分 0 秒 GMT (グリニッジ標準時) からのミリ秒数

関連項目:

setTime(long)

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 オブジェクト

関連項目:

Date.toLocaleString(), Date.toGMTString()

getNanos

public int getNanos()

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

戻り値:

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

関連項目:

setNanos(int)

setNanos

public void setNanos(int n)

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

パラメータ:

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

例外:

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

関連項目:

getNanos()

equals

public boolean equals(Timestamp ts)

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

パラメータ:

ts - 比較対象の Timestamp 値

戻り値:

指定された Timestamp オブジェクトがこの Timestamp オブジェクトと等しい場合は true、そうでない場合は false

equals

public boolean equals(Object ts)

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

オーバーライド:

クラス Date 内の equals

パラメータ:

ts - 比較対象の Object 値

戻り値:

指定された Object のインスタンスがこの Timestamp オブジェクトと等しい場合は true、そうでない場合は false

関連項目:

Date.getTime()

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

compareTo

public int compareTo(Timestamp ts)

順序付けのために 2 つの Timestamp を比較します。

パラメータ:

ts - 比較対象の Timestamp

戻り値:

引数 Timestamp がこの Timestamp と等しい場合は値 0。この Timestamp が引数 Date より前の場合は 0 より小さい値。この Timestamp が引数 Timestamp より後の場合は 0 より大きい値

導入されたバージョン:

1.2

compareTo

public int compareTo(Object o)

この Timestamp を別の Object と比較します。Object が Date の場合、この関数の動作は compareTo(Timestamp) と同様です。そうでない場合は、ClassCastException をスローします (Timestamp はほかの Timestamp とだけ比較できるため)。

定義:

インタフェース Comparable 内の compareTo

オーバーライド:

クラス Date 内の compareTo

パラメータ:

o - 比較対象の object

戻り値:

引数がこの Timestamp と等しい Timestamp の場合は値 0。引数がこの Timestamp より後の Timestamp の場合は 0 より小さい値。引数がこの Timestamp の前の Timestamp の場合は 0 より大きい値

例外:

ClassCastException - 引数が Timestamp ではない場合

関連項目:

Comparable