概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法

java.sql
類別 Timestamp

java.lang.Object
  繼承者 java.util.Date
      繼承者 java.sql.Timestamp
所有已實作的介面：
Serializable, Cloneable, Comparable<Date>
public class Timestamp
extends Date

一個與 java.util.Date 類別有關的精簡型外覆器 (thin wrapper)，它允許 JDBC API 將該類別標識為 SQL TIMESTAMP 值。它通過允許小數秒到納秒級精度的規範來添加保存 SQL TIMESTAMP 小數秒值的能力。Timestamp 也提供支持時間戳值的 JDBC 轉義語法的格式化和解析操作的能力。

計算 Timestamp 物件的精度為二者之一：

註：此型別由 java.util.Date 和單獨的毫微秒值組成。只有整數秒才會存儲在 java.util.Date 元件中。小數秒（毫微秒）是獨立存在的。傳遞不是 java.sql.Timestamp 實例的物件時，Timestamp.equals(Object) 方法永遠不會返回 true，因為日期的毫微秒元件是未知的。因此，相對於 java.util.Date.equals(Object) 方法而言，Timestamp.equals(Object) 方法是不對稱的。此外，hashcode 方法使用底層 java.util.Date 實作並因此在其計算中不包括毫微秒。

鑒於 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（必須為 Timestamp 物件）相比較。
 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 以來的毫秒數。
 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, hashCode, 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 - 如果毫微參數超出範圍

Timestamp

public Timestamp(long time)
使用毫秒時間值建構 Timestamp 物件。整數秒存儲在底層日期值中；小數秒存儲在 Timestamp 物件的 nanos 欄位中。

參數：
time - 自 1970 年 1 月 1 日 00:00:00 GMT 以來的毫秒數。負數表示 1970 年 1 月 1 日 00:00:00 GMT 之前的毫秒數。
另請參見：
Calendar
方法詳細資訊

setTime

public void setTime(long time)
設置此 Timestamp 物件，以表示 1970 年 1 月 1 日 00:00:00 GMT 以後 time 毫秒的時間點。

覆寫：
類別 Date 中的 setTime
參數：
time - 毫秒數。
另請參見：
getTime(), Timestamp(long time), Calendar

getTime

public long getTime()
返回此 Timestamp 物件表示的自 1970 年 1 月 1 日 00:00:00 GMT 以來的毫秒數。

覆寫：
類別 Date 中的 getTime
返回：
此日期表示的自 1970 年 1 月 1 日 00:00:00 GMT 以來的毫秒數。
另請參見：
setTime(long)

valueOf

public static Timestamp valueOf(String s)
將使用 JDBC 時間戳轉義格式的 String 物件轉換為 Timestamp 值。

參數：
s - 使用 yyyy-mm-dd hh:mm:ss[.f...] 格式的時間戳。可以省略小數秒。
返回：
相應的 Timestamp 值
拋出：
IllegalArgumentException - 如果給定的參數不具有 yyyy-mm-dd hh:mm:ss[.f...] 格式

toString

public String toString()
使用 JDBC 時間戳轉義格式編排時間戳。yyyy-mm-dd hh:mm:ss.fffffffff，其中 ffffffffff 指示毫微秒。

覆寫：
類別 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 物件的 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 物件
返回：
如果兩個 Timestamp 物件相等，則返回值 0；如果此 Timestamp 物件早於給定參數，則返回小於 0 的值；如果此 Timestamp 物件晚於給定參數，則返回大於 0 的值。
從以下版本開始：
1.4

compareTo

public int compareTo(Date o)
將此 Timestamp 物件與給定的 Date（必須為 Timestamp 物件）相比較。如果參數不是 Timestamp 物件，則此方法拋出 ClassCastException 物件。（Timestamp 只有與其他的 Timestamp 物件相比較。）

指定者：
介面 Comparable<Date> 中的 compareTo
覆寫：
類別 Date 中的 compareTo
參數：
o - 要比較的 Date，必須為 Timestamp 物件
返回：
如果此 Timestamp 物件與給定物件相等，則返回值 0；如果此 Timestamp 物件早於給定參數，則返回小於 0 的值；如果此 Timestamp 物件晚於給定參數，則返回大於 0 的值。
從以下版本開始：
1.5
概觀  軟體套件   類別  使用  階層樹  已過時  索引  說明 
JavaTM 2 Platform
Standard Ed. 6
 上一個類別   下一個類別 框架    無框架    
摘要： 巢狀 | 欄位 | 建構子 | 方法 詳細資訊： 欄位 | 建構子 | 方法
提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。