Timestamp (Java Platform SE 7)

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

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

Serializable, Cloneable, Comparable<Date>
```
public class Timestamp
extends Date
```
このクラスは、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 の継承関係は、型の継承ではなく、実装の継承を示します。
関連項目:
直列化された形式

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`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(Date o)` この `Timestamp` オブジェクトを指定された `Date` オブジェクトと比較します。
`int`	`compareTo(Timestamp ts)` この `Timestamp` オブジェクトを指定された `Timestamp` オブジェクトと比較します。
`boolean`	`equals(Object ts)` この `Timestamp` オブジェクトが指定されたオブジェクトと等しいかどうかを判定します。
`boolean`	`equals(Timestamp ts)` この `Timestamp` オブジェクトが指定された `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` ミリ秒の時点を表すように設定します。
`String`	`toString()` タイムスタンプを JDBC タイムスタンプエスケープ形式にフォーマットします。
`static Timestamp`	`valueOf(String s)` JDBC タイムスタンプエスケープ形式の `String` オブジェクトを `Timestamp` 値に変換します。

クラス java.util.Date から継承されたメソッド
after, before, clone, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTimezoneOffset, getYear, parse, setDate, setHours, setMinutes, setMonth, setSeconds, setYear, toGMTString, toLocaleString, UTC

クラス java.lang.Object から継承されたメソッド
finalize, getClass, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - Timestamp
```
@Deprecated
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 (グリニッジ標準時) より前のミリ秒。
    関連項目:
    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。ffffffffff はナノ秒を示します。
    
    オーバーライド:
    
    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)

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス Timestamp

コンストラクタのサマリー

メソッドのサマリー

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

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

コンストラクタの詳細

Timestamp

Timestamp

メソッドの詳細

setTime

getTime

valueOf

toString

getNanos

setNanos

equals

equals

before

after

compareTo

compareTo

hashCode