- java.lang.Object
-
- java.util.Date
-
- java.sql.Timestamp
-
- すべての実装されたインタフェース:
Serializable
,Cloneable
,Comparable<Date>
public class Timestamp extends Date
このクラスは、
java.util.Date
の薄いラッパーで、このラッパーによってJDBC APIはこれをSQLTIMESTAMP
値として識別できます。 このクラスは、小数点以下の秒数の仕様でナノ秒の精度を許可することにより、SQLTIMESTAMP
の小数点以下の秒数値を保持する機能を追加します。 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
の継承関係は、型の継承ではなく、実装の継承を示します。- 導入されたバージョン:
- 1.1
- 関連項目:
- 直列化された形式
-
-
メソッドのサマリー
すべてのメソッド staticメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 boolean
after(Timestamp ts)
このTimestamp
オブジェクトが、指定されたTimestamp
オブジェクトより遅い時間かどうかを示します。boolean
before(Timestamp ts)
このTimestamp
オブジェクトが、指定されたTimestamp
オブジェクトより早い時間かどうかを示します。int
compareTo(Timestamp ts)
このTimestamp
オブジェクトを指定されたTimestamp
オブジェクトと比較します。int
compareTo(Date o)
このTimestamp
オブジェクトを指定されたDate
オブジェクトと比較します。boolean
equals(Object ts)
このTimestamp
オブジェクトが指定されたオブジェクトと等しいかどうかを判定します。boolean
equals(Timestamp ts)
このTimestamp
オブジェクトが指定されたTimestamp
オブジェクトと等しいかどうかを判定します。static Timestamp
from(Instant instant)
Instant
オブジェクトからTimestamp
のインスタンスを取得します。int
getNanos()
このTimestamp
オブジェクトのnanos
値を取得します。long
getTime()
このTimestamp
オブジェクトで表される、1970年1月1日00:00:00 GMTからのミリ秒数を返します。int
hashCode()
このオブジェクトに対するハッシュ・コード値を返します。void
setNanos(int n)
このTimestamp
オブジェクトのnanos
フィールドを指定された値に設定します。void
setTime(long time)
このTimestamp
オブジェクトを、1970年1月1日00:00:00 GMTからtime
ミリ秒の時点を表すように設定します。Instant
toInstant()
このTimestamp
オブジェクトをInstant
に変換します。LocalDateTime
toLocalDateTime()
このTimestamp
オブジェクトをLocalDateTime
に変換します。String
toString()
タイムスタンプをJDBCタイムスタンプ・エスケープ形式にフォーマットします。static Timestamp
valueOf(String s)
JDBCタイムスタンプ・エスケープ形式のString
オブジェクトをTimestamp
値に変換します。static Timestamp
valueOf(LocalDateTime dateTime)
指定されたLocalDateTime
と同じ年、月、「月の日」、時、分、秒およびナノ秒の日付/時間値を持つTimestamp
のインスタンスをLocalDateTime
オブジェクトから取得します。-
クラス java.util.Dateで宣言されたメソッド
after, before, clone, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTimezoneOffset, getYear, parse, setDate, setHours, setMinutes, setMonth, setSeconds, setYear, toGMTString, toLocaleString, UTC
-
-
-
-
コンストラクタの詳細
-
Timestamp
@Deprecated(since="1.2") public Timestamp(int year, int month, int date, int hour, int minute, int second, int nano)
非推奨。代わりに、コンストラクタTimestamp(long millis)
を使用します指定された値で初期化されたTimestamp
オブジェクトを構築します。- パラメータ:
year
- 年から1900を引いたものmonth
- 0 - 11date
- 1 - 31hour
- 0 - 23minute
- 0 - 59second
- 0 - 59nano
- 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 (グリニッジ標準時)より前のミリ秒。- 関連項目:
Calendar
-
-
メソッドの詳細
-
setTime
public void setTime(long time)
このTimestamp
オブジェクトを、1970年1月1日00:00:00 GMTからtime
ミリ秒の時点を表すように設定します。- オーバーライド:
setTime
、クラスDate
- パラメータ:
time
- ミリ秒数。- 関連項目:
getTime()
,Timestamp(long time)
,Calendar
-
getTime
public long getTime()
このTimestamp
オブジェクトで表される、1970年1月1日00:00:00 GMTからのミリ秒数を返します。- オーバーライド:
getTime
、クラスDate
- 戻り値:
- この日付で表される、1970年1月1日00:00:00 GMTからのミリ秒数。
- 関連項目:
setTime(long)
-
valueOf
public static Timestamp valueOf(String s)
JDBCタイムスタンプ・エスケープ形式のString
オブジェクトをTimestamp
値に変換します。- パラメータ:
s
-yyyy-[m]m-[d]d hh:mm:ss[.f...]
形式のタイムスタンプ。 小数点以下の秒数は省略されることがある。mm
とdd
の先頭のゼロは省略できる。- 戻り値:
- 対応する
Timestamp
値 - 例外:
IllegalArgumentException
- 指定された引数がyyyy-[m]m-[d]d hh:mm:ss[.f...]
形式でない場合
-
toString
public String toString()
JDBCタイムスタンプ・エスケープ形式でタイムスタンプをフォーマットします。yyyy-mm-dd hh:mm:ss.fffffffff
、ここで、fffffffff
はナノ秒を示します。- オーバーライド:
toString
、クラスDate
- 戻り値:
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)
メソッドと対称ではありません。- オーバーライド:
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
より大きい値 - 導入されたバージョン:
- 1.4
-
compareTo
public int compareTo(Date o)
このTimestamp
オブジェクトを指定されたDate
オブジェクトと比較します。- 定義:
compareTo
、インタフェースComparable<Date>
- オーバーライド:
compareTo
、クラスDate
- パラメータ:
o
-このTimestamp
オブジェクトの比較対象のDate
- 戻り値:
- この
Timestamp
オブジェクトと指定されたオブジェクトが等しい場合は値0
、このTimestamp
オブジェクトが引数に指定されたオブジェクトより早い時間である場合は0
未満の値、このTimestamp
オブジェクトが引数に指定されたオブジェクトより遅い時間である場合は0
より大きい値 - 導入されたバージョン:
- 1.5
-
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の場合。- 導入されたバージョン:
- 1.8
-
toLocalDateTime
public LocalDateTime toLocalDateTime()
このTimestamp
オブジェクトをLocalDateTime
に変換します。この変換によって、ローカル・タイムゾーンでこの
Timestamp
と同じ年、月、「月の日」、時、分、秒およびナノ秒の日付/時間値を表すLocalDateTime
が作成されます。- 戻り値:
- 同じ日付/時間値を表す
LocalDateTime
オブジェクト - 導入されたバージョン:
- 1.8
-
from
public static Timestamp from(Instant instant)
Instant
オブジェクトからTimestamp
のインスタンスを取得します。Instant
には、Date
より遠い未来または過去にある時系列上の時点を格納できます。 このシナリオでは、このメソッドは例外をスローします。- パラメータ:
instant
- 変換するインスタント- 戻り値:
- 指定されたインスタントと同じ時系列上の時点を表す
Timestamp
- 例外:
NullPointerException
-instant
がnullの場合。IllegalArgumentException
- インスタントが大きすぎてTimestamp
として表現できない場合- 導入されたバージョン:
- 1.8
-
-