このクラスは、
java.util.Date
の薄いラッパーで、このラッパーによってJDBC APIはこれをSQL
TIMESTAMP
値として識別できます。このクラスは、小数点以下の秒数の仕様でナノ秒の精度を許可することにより、SQL
TIMESTAMP
の小数点以下の秒数値を保持する機能を追加します。Timestampは、タイムスタンプ値のJDBCエスケープ構文をサポートするためのフォーマットと構文解析操作も提供します。
Timestampオブジェクトの精度は、次のように計算されます。
19
。yyyy-mm-dd hh:mm:ss形式での文字数です
20+s
。yyyy-mm-dd hh:mm:ss.[fff...]形式での文字数であり、
s
は指定されたTimestampのスケール(小数点以下の秒数の精度)を表します。
注:
この型は
java.util.Date
とナノ秒値からなります。
java.util.Date
構成要素内に格納されるのは秒の整数部分だけです。秒の小数点以下(nanos値)は別の構成要素内に格納されます。
Timestamp.equals(Object)
メソッドは、
java.sql.Timestamp
のインスタンスでないオブジェクトが渡された場合は
true
を返しません。なぜなら、その日付のnanos構成要素が不明だからです。そのため、
Timestamp.equals(Object)
メソッドは
java.util.Date.equals(Object)
メソッドと対称ではありません。また、
hashCode
メソッドは基となる
java.util.Date
実装を使用するため、その計算にnanos値を含みません。
上記のような
Timestamp
クラスと
java.util.Date
クラスの違いのため、
Timestamp
値は
java.util.Date
のインスタンスとして考えないでください。
Timestamp
と
java.util.Date
の継承関係は、型の継承ではなく、実装の継承を示します。
タイムスタンプをJDBCタイムスタンプ・エスケープ形式にフォーマットします。
yyyy-mm-dd hh:mm:ss.fffffffff
。
ffffffffff
はナノ秒を示します。
オーバーライド:
toString
、クラス:
Date
yyyy-mm-dd hh:mm:ss.fffffffff
形式の
String
オブジェクト
関連項目:
Date.toLocaleString()
,
Date.toGMTString()
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)
メソッドと対称ではありません。
オーバーライド:
equals
、クラス:
Date
パラメータ:
ts
- 比較対象の
Object
値
指定された
Object
が
Timestamp
のインスタンスで、この
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)
この
Timestamp
オブジェクトを指定された
Timestamp
オブジェクトと比較します。
パラメータ:
ts
-この
Timestamp
オブジェクトの比較対象の
Timestamp
オブジェクト
2つの
Timestamp
オブジェクトが等しい場合は値
0
、この
Timestamp
オブジェクトが引数に指定されたオブジェクトより早い時間である場合は
0
未満の値、この
Timestamp
オブジェクトが引数に指定されたオブジェクトより遅い時間である場合は
0
より大きい値
導入されたバージョン:
o
-この
Timestamp
オブジェクトの比較対象の
Date
この
Timestamp
オブジェクトと指定されたオブジェクトが等しい場合は値
0
、この
Timestamp
オブジェクトが引数に指定されたオブジェクトより早い時間である場合は
0
未満の値、この
Timestamp
オブジェクトが引数に指定されたオブジェクトより遅い時間である場合は
0
より大きい値
導入されたバージョン:
hashCode
public int hashCode()
このオブジェクトに対するハッシュ・コード値を返します。結果は、
Date.getTime()
メソッドによって返されるプリミティブ
long
値の上位半分と下位半分の排他的論理和です。すなわち、ハッシュ・コードは次の式の値です。
(int)(this.getTime()^(this.getTime() >>> 32))
hashCode
メソッドは基となる
java.util.Date
実装を使用するため、その計算にnanos値を含みません。
オーバーライド:
hashCode
、クラス:
Date
このオブジェクトのハッシュ・コード値。
関連項目:
Object.equals(java.lang.Object)
,
System.identityHashCode(java.lang.Object)
valueOf
public static Timestamp valueOf(LocalDateTime dateTime)
指定された
LocalDateTime
と同じ年、月、「月の日」、時、分、秒およびナノ秒の日付/時間値を持つ
Timestamp
のインスタンスを
LocalDateTime
オブジェクトから取得します。
指定された
LocalDateTime
は、ローカル・タイムゾーンのローカル日付/時間として解釈されます。
パラメータ:
dateTime
- 変換する
LocalDateTime
Timestamp
オブジェクト
NullPointerException
-
dateTime
がnullの場合。
導入されたバージョン:
toLocalDateTime
public LocalDateTime toLocalDateTime()
この
Timestamp
オブジェクトを
LocalDateTime
に変換します。
この変換によって、ローカル・タイムゾーンでこの
Timestamp
と同じ年、月、「月の日」、時、分、秒およびナノ秒の日付/時間値を表す
LocalDateTime
が作成されます。
同じ日付/時間値を表す
LocalDateTime
オブジェクト
導入されたバージョン:
public static Timestamp from(Instant instant)
Instant
オブジェクトから
Timestamp
のインスタンスを取得します。
Instant
には、
Date
より遠い未来または過去にある時系列上の時点を格納できます。このシナリオでは、このメソッドは例外をスローします。
パラメータ:
instant
- 変換するインスタント
指定されたインスタントと同じ時系列上の時点を表す
Timestamp
NullPointerException
-
instant
がnullの場合。
IllegalArgumentException
- インスタントが
Timesamp
で表すには大きすぎる場合
導入されたバージョン: