java.sql
類別 Date

java.lang.Object
  java.util.Date
      java.sql.Date

所有已實作的介面：

Serializable, Cloneable, Comparable<Date>

public class Date
extends Date

一個套件裝了毫秒值的精簡型外覆器 (thin wrapper)，它允許 JDBC 將毫秒值標識為 SQL DATE 值。毫秒值表示自 1970 年 1 月 1 日 00:00:00 GMT 以來經過的毫秒數。

為了與 SQL DATE 的定義一致，由 java.sql.Date 實例包裹的毫秒值必須通過將小時、分鐘、秒和毫秒設置為與該實例相關的特定時區中的零來“規範化”。

另請參見：

序列化表格

建構子摘要

Date(int year, int month, int day)
已過時。 使用建構子 Date(long date) 替代

Date(long date)
使用給定毫秒時間值建構一個 Date 物件。

方法摘要

int	getHours() 已過時。
int	getMinutes() 已過時。
int	getSeconds() 已過時。
void	setHours(int i) 已過時。
void	setMinutes(int i) 已過時。
void	setSeconds(int i) 已過時。
void	setTime(long date) 使用給定毫秒時間值設置現有 Date 物件。
String	toString() 格式化日期轉義形式 yyyy-mm-dd 的日期。
static Date	valueOf(String s) 將 JDBC 日期轉義形式的字元串轉換成 Date 值。

從類別 java.util.Date 繼承的方法

after, before, clone, compareTo, equals, getDate, getDay, getMonth, getTime, getTimezoneOffset, getYear, hashCode, parse, setDate, setMonth, setYear, toGMTString, toLocaleString, UTC

從類別 java.lang.Object 繼承的方法

finalize, getClass, notify, notifyAll, wait, wait, wait

建構子詳細資訊

Date

public Date(int year,
            int month,
            int day)

已過時。 使用建構子 Date(long date) 替代

建構一個使用給定 year、month 和 day 初始化的 Date 物件。

如果給定參數超出範圍，則結果是不確定的。

參數：

year - year 減去 1900，它必須是 0 到 8099 之間的數。（注意，8099 是由 9999 減去 1900 得到的。）

month - 0 到 11 之間的數

day - 1 到 31 之間的數

Date

public Date(long date)

使用給定毫秒時間值建構一個 Date 物件。如果給定毫秒值包含時間資訊，則驅動程序會將時間元件設置為對應於零 GMT 的預設時區（運行應用程序的 Java 虛擬機器的時區）中的時間。

參數：

date - 不超過 year 8099 的毫秒表示的自 1970 年 1 月 1 日 00:00:00 GMT 以來的毫秒數。負數指示在 1970 年 1 月 1 日 00:00:00 GMT 之前的毫秒數。

方法詳細資訊

setTime

public void setTime(long date)

使用給定毫秒時間值設置現有 Date 物件。如果給定毫秒值包含時間資訊，則驅動程序會將時間元件設置為對應於零 GMT 的預設時區（運行應用程序的 Java 虛擬機器的時區）中的時間。

覆寫：

類別 Date 中的 setTime

參數：

date - 不超過 year 8099 的毫秒表示的自 1970 年 1 月 1 日 00:00:00 GMT 以來的毫秒數。負數指示在 1970 年 1 月 1 日 00:00:00 GMT 之前的毫秒數。

valueOf

public static Date valueOf(String s)

將 JDBC 日期轉義形式的字元串轉換成 Date 值。

參數：

s - 表示 "yyyy-mm-dd" 形式的日期的 String 物件

返回：

表示給定日期的 java.sql.Date 物件

拋出：

IllegalArgumentException - 如果給定日期不是 JDBC 日期轉義形式 (yyyy-mm-dd)

toString

public String toString()

格式化日期轉義形式 yyyy-mm-dd 的日期。

覆寫：

類別 Date 中的 toString

返回：

一個 yyyy-mm-dd 形式的 String

另請參見：

Date.toLocaleString(), Date.toGMTString()

getHours

public int getHours()

已過時。

因為 SQL Date 值沒有時間元件，所以不建議並且不應使用此方法。

覆寫：

類別 Date 中的 getHours

返回：

此日期所表示的小時。

拋出：

IllegalArgumentException - 如果調用此方法

另請參見：

setHours(int)

getMinutes

public int getMinutes()

已過時。

因為 SQL Date 值沒有時間元件，所以不建議並且不應使用此方法。

覆寫：

類別 Date 中的 getMinutes

返回：

此日期所表示的小時已經過去的分鐘數。

拋出：

IllegalArgumentException - 如果調用此方法

另請參見：

setMinutes(int)

getSeconds

public int getSeconds()

已過時。

因為 SQL Date 值沒有時間元件，所以不建議並且不應使用此方法。

覆寫：

類別 Date 中的 getSeconds

返回：

此日期表示的分鐘已經過去的秒數。

拋出：

IllegalArgumentException - 如果調用此方法

另請參見：

setSeconds(int)

setHours

public void setHours(int i)

已過時。

因為 SQL Date 值沒有時間元件，所以不建議並且不應使用此方法。

覆寫：

類別 Date 中的 setHours

參數：

i - 小時值。

拋出：

IllegalArgumentException - 如果調用此方法

另請參見：

getHours()

setMinutes

public void setMinutes(int i)

已過時。

因為 SQL Date 值沒有時間元件，所以不建議並且不應使用此方法。

覆寫：

類別 Date 中的 setMinutes

參數：

i - 分鐘值。

拋出：

IllegalArgumentException - 如果調用此方法

另請參見：

getMinutes()

setSeconds

public void setSeconds(int i)

已過時。

因為 SQL Date 值沒有時間元件，所以不建議並且不應使用此方法。

覆寫：

類別 Date 中的 setSeconds

參數：

i - 秒數值。

拋出：

IllegalArgumentException - 如果調用此方法

另請參見：

getSeconds()