java.util
類別 Date

java.lang.Object
  java.util.Date

所有已實作的介面：

Serializable, Cloneable, Comparable<Date>

直接已知子類別：

Date, Time, Timestamp

public class Date
extends Object
implements Serializable, Cloneable, Comparable<Date>

類別 Date 表示特定的瞬間，精確到毫秒。

在 JDK 1.1 之前，類別 Date 有兩個其他的函數。它允許把日期解釋為年、月、日、小時、分鐘和秒值。它也允許格式化和解析日期字元串。不過，這些函數的 API 不易於實作國際化。從 JDK 1.1 開始，應該使用 Calendar 類別實作日期和時間欄位之間轉換，使用 DateFormat 類別來格式化和解析日期字元串。Date 中的相應方法已廢棄。

儘管 Date 類別打算反映協調世界時 (UTC)，但無法做到如此準確，這取決於 Java 虛擬機器的主機環境。當前幾乎所有作業系統都假定 1 天 = 24 × 60 × 60 = 86400 秒。但對於 UTC，大約每一兩年出現一次額外的一秒，稱為“閏秒”。閏秒始終作為當天的最後一秒增加，並且始終在 12 月 31 日或 6 月 30 日增加。例如，1995 年的最後一分鐘是 61 秒，因為增加了閏秒。大多數電腦時鐘不是特別的準確，因此不能反映閏秒的差別。

一些電腦標準是按照格林威治標準時 (GMT) 定義的，格林威治標準時和世界時 (UT) 是相等的。GMT 是標準的“民間”名稱；UT 是相同標準的“科學”名稱。UTC 和 UT 的區別是：UTC 是基於原子時鐘的，UT 是基於天體觀察的，兩者在實際應用中難分軒輊。因為地球的旋轉不是均勻的（它以複雜的方式減速和加速），所以 UT 始終不是均勻地串流過。閏秒是根據需要引入 UTC 的，以便把 UTC 保持在 UT1 的 0.9 秒之內，UT1 是應用了某些更正的 UT 版本。還有其他的時間和日期系統；例如，基於衛星的全球定位系統 (GPS) 使用的時間刻度與 UTC 同步，但沒有 針對閏秒進行調整。有關更多資訊的一個有趣來源是美國海軍天文台，特別是 Directorate of Time 的網址：

     http://tycho.usno.navy.mil
 

還有它們對 "Systems of Time" 的定義，網址為：

     http://tycho.usno.navy.mil/systime.html
 

在類別 Date 所有可以接受或返回年、月、日期、小時、分鐘和秒值的方法中，將使用下面的表示形式：

• 年份 y 由整數 y - 1900 表示。
• 月份由從 0 至 11 的整數表示；0 是一月、1 是二月等等；因此 11 是十二月。
• 日期（一月中的某天）按通常方式由整數 1 至 31 表示。
• 小時由從 0 至 23 的整數表示。因此，從午夜到 1 a.m. 的時間是 0 點，從中午到 1 p.m. 的時間是 12 點。
• 分鐘按通常方式由 0 至 59 的整數表示。
• 秒由 0 至 61 的整數表示；值 60 和 61 只對閏秒發生，儘管那樣，也只用在實際正確追蹤閏秒的 Java 實作中。於按當前引入閏秒的方式，兩個閏秒在同一分鐘內發生是極不可能的，但此規範遵循 ISO C 的日期和時間約定。

在所有情形中，針對這些目的賦予方法的參數不需要在指定的範圍內；例如，可以把日期指定為 1 月 32 日，並把它解釋為 2 月 1 日的相同含義。

從以下版本開始：

JDK1.0

另請參見：

DateFormat, Calendar, TimeZone, 序列化表格

建構子摘要

Date()
分派 Date 物件並初始化此物件，以表示分派它的時間（精確到毫秒）。

Date(int year, int month, int date)
已過時。 從 JDK 1.1 開始，由 Calendar.set(year + 1900, month, date) 或 GregorianCalendar(year + 1900, month, date) 取代。

Date(int year, int month, int date, int hrs, int min)
已過時。 從 JDK 1.1 開始，由 Calendar.set(year + 1900, month, date, hrs, min) 或 GregorianCalendar(year + 1900, month, date, hrs, min) 取代。

Date(int year, int month, int date, int hrs, int min, int sec)
已過時。 從 JDK 1.1 開始，由 Calendar.set(year + 1900, month, date, hrs, min, sec) 或 GregorianCalendar(year + 1900, month, date, hrs, min, sec) 取代。

Date(long date)
分派 Date 物件並初始化此物件，以表示自從標準基準時間（稱為“歷元（epoch）”，即 1970 年 1 月 1 日 00:00:00 GMT）以來的指定毫秒數。

Date(String s)
已過時。 從 JDK 1.1 開始，由 DateFormat.parse(String s) 取代。

方法摘要

boolean	after(Date when) 測試此日期是否在指定日期之後。
boolean	before(Date when) 測試此日期是否在指定日期之前。
Object	clone() 返回此物件的副本。
int	compareTo(Date anotherDate) 比較兩個日期的順序。
boolean	equals(Object obj) 比較兩個日期的相等性。
int	getDate() 已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.DAY_OF_MONTH) 取代。
int	getDay() 已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.DAY_OF_WEEK) 取代。
int	getHours() 已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.HOUR_OF_DAY) 取代。
int	getMinutes() 已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.MINUTE) 取代。
int	getMonth() 已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.MONTH) 取代。
int	getSeconds() 已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.SECOND) 取代。
long	getTime() 返回自 1970 年 1 月 1 日 00:00:00 GMT 以來此 Date 物件表示的毫秒數。
int	getTimezoneOffset() 已過時。 從 JDK 1.1 開始，由 -(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000) 取代。
int	getYear() 已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.YEAR) - 1900 取代。
int	hashCode() 返回此物件的雜湊碼值。
static long	parse(String s) 已過時。 從 JDK 1.1 開始，由 DateFormat.parse(String s) 取代。
void	setDate(int date) 已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.DAY_OF_MONTH, int date) 取代。
void	setHours(int hours) 已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.HOUR_OF_DAY, int hours) 取代。
void	setMinutes(int minutes) 已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.MINUTE, int minutes) 取代。
void	setMonth(int month) 已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.MONTH, int month) 取代。
void	setSeconds(int seconds) 已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.SECOND, int seconds) 取代。
void	setTime(long time) 設置此 Date 物件，以表示 1970 年 1 月 1 日 00:00:00 GMT 以後 time 毫秒的時間點。
void	setYear(int year) 已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.YEAR, year + 1900) 取代。
String	toGMTString() 已過時。 從 JDK 1.1 開始，由 DateFormat.format(Date date) 取代，使用 GMT TimeZone。
String	toLocaleString() 已過時。 從 JDK 1.1 開始，由 DateFormat.format(Date date) 取代。
String	toString() 把此 Date 物件轉換為以下形式的 String： dow mon dd hh:mm:ss zzz yyyy 其中： dow 是一周中的某一天 (Sun, Mon, Tue, Wed, Thu, Fri, Sat)。
static long	UTC(int year, int month, int date, int hrs, int min, int sec) 已過時。 從 JDK 1.1 開始，由 Calendar.set(year + 1900, month, date, hrs, min, sec) 或 GregorianCalendar(year + 1900, month, date, hrs, min, sec) 取代，使用 UTC TimeZone，後跟 Calendar.getTime().getTime()。

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

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

建構子詳細資訊

Date

public Date()

分派 Date 物件並初始化此物件，以表示分派它的時間（精確到毫秒）。

另請參見：

System.currentTimeMillis()

Date

public Date(long date)

分派 Date 物件並初始化此物件，以表示自從標準基準時間（稱為“歷元（epoch）”，即 1970 年 1 月 1 日 00:00:00 GMT）以來的指定毫秒數。

參數：

date - 自 1970 年 1 月 1 日 00:00:00 GMT 以來的毫秒數。

另請參見：

System.currentTimeMillis()

Date

@Deprecated
public Date(int year,
                       int month,
                       int date)

已過時。 從 JDK 1.1 開始，由 Calendar.set(year + 1900, month, date) 或 GregorianCalendar(year + 1900, month, date) 取代。

分派 Date 物件並初始化此物件，以表示由 year、month 和 date 參數指定的一天的開始時間（本地時間晚上 12 時）。

參數：

year - 減 1900 的年份。

month - 0-11 的月份。

date - 一月中 1-31 之間的某一天。

另請參見：

Calendar

Date

@Deprecated
public Date(int year,
                       int month,
                       int date,
                       int hrs,
                       int min)

已過時。 從 JDK 1.1 開始，由 Calendar.set(year + 1900, month, date, hrs, min) 或 GregorianCalendar(year + 1900, month, date, hrs, min) 取代。

分派 Date 物件並初始化此物件，以表示本地時區中由 year、month、date、hrs 和 min 參數指定的分鐘的開始瞬間。

參數：

year - 減 1900 的年份。

month - 0-11 之間的月份。

date - 一月中 1-31 之間的某一天。

hrs - 0-23 之間的小時數。

min - 0-59 之間的分鐘數。

另請參見：

Calendar

Date

@Deprecated
public Date(int year,
                       int month,
                       int date,
                       int hrs,
                       int min,
                       int sec)

已過時。 從 JDK 1.1 開始，由 Calendar.set(year + 1900, month, date, hrs, min, sec) 或 GregorianCalendar(year + 1900, month, date, hrs, min, sec) 取代。

分派 Date 物件，並初始化此物件，以表示本地時區中由 year、month、date、hrs、min 和 sec 參數指定的秒的開始瞬間。

參數：

year - 減 1900 的年份。

month - 0-11 之間的月份。

date - 一月中 1-31 之間的某一天。

hrs - 0-23 之間的小時數。

min - 0-59 之間的分鐘數。

sec - 0-59 之間的秒數。

另請參見：

Calendar

Date

@Deprecated
public Date(String s)

已過時。 從 JDK 1.1 開始，由 DateFormat.parse(String s) 取代。

分派 Date 物件並初始化此物件，以表示字元串 s 指出的日期和時間，就像通過 parse(java.lang.String) 方法解釋一樣。

參數：

s - 日期的字元串表示形式。

另請參見：

DateFormat, parse(java.lang.String)

方法詳細資訊

clone

public Object clone()

返回此物件的副本。

覆寫：

類別 Object 中的 clone

返回：

此實例的一個副本。

另請參見：

Cloneable

UTC

@Deprecated
public static long UTC(int year,
                                  int month,
                                  int date,
                                  int hrs,
                                  int min,
                                  int sec)

已過時。 從 JDK 1.1 開始，由 Calendar.set(year + 1900, month, date, hrs, min, sec) 或 GregorianCalendar(year + 1900, month, date, hrs, min, sec) 取代，使用 UTC TimeZone，後跟 Calendar.getTime().getTime()。

根據參數確定日期和時間。這些參數被解釋為年份、月份、月中某一天、一天中的某一小時、小時中某一分鐘和分鐘中的某一秒。除了相對於 UTC 而不是本地時區解釋這些參數之外，該方法與帶 6 個參數的 Date 建構子完全相同。該方法將返回指示的時間，用該時間與歷元（1970 年 1 月 1 日，00:00:00 GMT）的時間差來表示（以毫秒為單位）。

參數：

year - 減 1900 的年份。

month - 0-11 之間的月份。

date - 一月中 1-31 之間的某一天。

hrs - 0-23 之間的小時數。

min - 0-59 之間的分鐘數。

sec - 0-59 之間的秒數。

返回：

對於參數指定的日期和時間，返回自 1970 年 1 月 1 日 00:00:00 GMT 以來的毫秒數。

另請參見：

Calendar

parse

@Deprecated
public static long parse(String s)

已過時。 從 JDK 1.1 開始，由 DateFormat.parse(String s) 取代。

嘗試把字元串 s 解釋為日期和時間的表示形式。如果嘗試成功，則返回指示的時間，用該時間與歷元（1970 年 1 月 1 日，00:00:00 GMT）的時間差來表示（以毫秒為單位）。如果嘗試失敗，則拋出 IllegalArgumentException。

它接受許多語法；特別是它識別 IETF 標準日期語法："Sat, 12 Aug 1995 13:30:00 GMT"。它也瞭解美國大陸時區縮寫，但對於一般用途，應該使用時區偏移量："Sat, 12 Aug 1995 13:30:00 GMT+0430"（比格林威治子午線晚 4 小時 30 分）。如果沒有指定時區，則假定用本地時區。GMT 和 UTC 被認為是相同的。

系統將從左到右處理字元串 s，從中尋找相應的資料。s 中包括在 ASCII 括號字元 ( 和 ) 中的任何內容都將被忽略。括號可以進行巢狀。另外，s 中只允許使用以下 ASCII 字元：

 abcdefghijklmnopqrstuvwxyz
 ABCDEFGHIJKLMNOPQRSTUVWXYZ
 0123456789,+-:/

以及空白字元。

連續的十進制位序列被當成十進制數：

• 如果數字前面有 + 或 -，並且已經識別了年份，那麼數字就是一個時區偏移量。如果數字少於 24，那麼它是以小時進行測量的偏移量。否則，它被認為是以分鐘進行測量的偏移量，用沒有標點的 24 小時時間格式來表示。前面的 - 意味著向西的偏移量。時區偏移量始終相對於 UTC（格林威治）。因此，例如，在字元串中出現的 -5 意味著“比格林威治時間晚 5 小時”，+0430 將意味著“比格林威治時間早 4 小時 30 分”。允許字元串冗餘地指定 GMT、UT 或 UTC——例如，GMT-5 或 utc+0430。
• 如果下面條件之一為真，數字就被認為是年數：
  • 數字等於或大於 70，並且後跟一個空格、逗號、斜槓或結束字元串
  • 數字小於 70，並且已經識別月份和月中的某一天
  如果被識別的年數小於 100，它就被解釋為相對於其日期所在世紀的縮寫年，縮寫年的日期位於初始化 Date 類別的時間的 80 年以前和 19 年以後之間。在調整年數後，從其減去 1900。例如，如果當前的年份是 1999，那麼範圍 19 至 99 的年數就被假定表示 1919 至 1999，而 0 至 18 的年數就被假定表示 2000 至 2018。注意，這與 SimpleDateFormat 中使用的小於 100 的年份具有稍微不同的解釋。
• 如果數字後跟一個冒號，則認為是小時，如果小時已經被識別，則認為是分鐘。
• 如果數字後跟一個斜槓，則認為是月份（把它減 1，以便產生範圍 0 至 11 的數字），如果月份已經被識別，則認為它是月中的某一天。
• 如果數字後跟空白、逗號、連字元或結束字元串，那麼如果小時已識別但分鐘未識別，則認為是分鐘；否則，如果分鐘已識別，而秒沒有識別，則認為是秒；否則，它被認為是月中的某一天。

連續的字母序列被認為是單詞，並按以下方法進行處理：

• 忽略比對 AM（忽略大小寫）的單詞（但如果小時尚未識別，或者小時小於 1 或大於 12，則解析失敗）。
• 比對 PM（忽略大小寫）的單詞，添加 12 到小時（但如果小時尚未識別，或者小時小於 1 或大於 12，則解析失敗）。
• 忽略比對 SUNDAY、MONDAY、TUESDAY、WEDNESDAY、THURSDAY、FRIDAY 或 SATURDAY 的任何前綴（忽略大小寫）的任何單詞。例如，sat、Friday、TUE 和 Thurs 會被忽略。
• 否則，比對 JANUARY、FEBRUARY、MARCH、APRIL、MAY、JUNE、JULY、AUGUST、SEPTEMBER、OCTOBER、NOVEMBER 或 DECEMBER 的任何前綴（忽略大小寫，並按這裡給出的順序考慮它們）的任何單詞都被識別為指定月份，並被轉換成一個數字（0 至 11）。例如，aug、Sept、april 和 NOV 被識別為月份。Ma 也是這樣，它被識別為 MARCH，而不是 MAY。
• 比對 GMT、UT 或 UTC（忽略大小寫）的任何單詞都認為是指 UTC。
• 比對 EST、CST、MST 或 PST（忽略大小寫）的任何單詞都被認為是指北美的時區，該時區分別比格林威治時間晚 5、6、7 或 8 小時。比對 EDT、CDT、MDT 或 PDT（忽略大小寫）的任何單詞都被識別為在夏令時期間分別指相同的時區。

一旦掃瞄了整個字元串，就以兩種方式之一把它轉換成時間結果。如果已經識別時區或時區偏移量，那麼年、月、月中某一天、小時、分鐘和秒以 UTC 進行解釋，然後應用時區偏移量。否則，年、月、月中某一天、小時、分鐘和秒用本地時區進行解釋。

參數：

s - 要解析為日期的字元串。

返回：

自 1970 年 1 月 1 日 00:00:00 GMT 以來字元串參數表示的毫秒數。

另請參見：

DateFormat

getYear

@Deprecated
public int getYear()

已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.YEAR) - 1900 取代。

返回一個值，此值是從套件含或開始於此 Date 物件表示的瞬間的年份減去 1900 的結果（用本地時區進行解釋）。

返回：

日期表示的年份減去 1900。

另請參見：

Calendar

setYear

@Deprecated
public void setYear(int year)

已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.YEAR, year + 1900) 取代。

把此 Date 物件的年份設置為指定的值加 1900。修改此 Date 物件，以便它用與以前相同的月份、日期、小時、分鐘和秒表示指定年份中的時間點（用本地時區進行解釋）。（當然，例如，如果日期是 2 月 29 日，並且年份被設置到非閏年，那麼新日期將被看作 3 月 1 日。）

參數：

year - 年份值。

另請參見：

Calendar

getMonth

@Deprecated
public int getMonth()

已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.MONTH) 取代。

返回表示月份的數字，該月份包含或開始於此 Date 物件所表示的瞬間。返回的值在 0 和 11 之間，值 0 表示 1 月。

返回：

此日期所表示的月份。

另請參見：

Calendar

setMonth

@Deprecated
public void setMonth(int month)

已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.MONTH, int month) 取代。

把此日期的月份設置為指定值。修改此 Date 物件，以便它用與以前一樣的年份、日期、小時、分鐘和秒表示指定月份中的時間點（用本地時區進行解釋）。例如，如果日期是 10 月 31 日，並將月份設置為 6 月，那麼新日期將被看作 7 月 1 日，因為 6 月只有 30 天。

參數：

month - 0-11 之間的月份值。

另請參見：

Calendar

getDate

@Deprecated
public int getDate()

已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.DAY_OF_MONTH) 取代。

返回此 Date 物件表示的月份中的某一天。返回的值在 1 和 31 之間，表示包含或開始於此 Date 物件表示的時間的月份中的某一天（用本地時區進行解釋）。

返回：

此日期所表示的月份中的某一天。

另請參見：

Calendar

setDate

@Deprecated
public void setDate(int date)

已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.DAY_OF_MONTH, int date) 取代。

把此 Date 物件的月份中的某一天設置為指定值。修改此 Date 物件，以便它用與以前一樣的年份、月份、小時、分鐘和秒表示月份中指定某一天中的時間點（用本地時區進行解釋）。例如，如果日期是 4 月 30 日，並且日期被設置為 31，那麼它將被看作 5 月 1 日，因為 4 月只有 30 天。

參數：

date - 月份中 1-31 之間的某一天。

另請參見：

Calendar

getDay

@Deprecated
public int getDay()

已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.DAY_OF_WEEK) 取代。

返回此日期表示的周中的某一天。返回值 (0 = Sunday, 1 = Monday, 2 = Tuesday, 3 = Wednesday, 4 = Thursday, 5 = Friday, 6 = Saturday) 表示一周中的某一天，該周包含或開始於此 Date 物件所表示的瞬間（用本地時區進行解釋）。

返回：

此日期所表示的一周中的某一天。

另請參見：

Calendar

getHours

@Deprecated
public int getHours()

已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.HOUR_OF_DAY) 取代。

返回此 Date 物件表示的小時。返回值是一個數字（0 至 23），表示包含或開始於此 Date 物件表示的瞬間的一天中的小時（用本地時區進行解釋）。

返回：

此日期所表示的小時。

另請參見：

Calendar

setHours

@Deprecated
public void setHours(int hours)

已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.HOUR_OF_DAY, int hours) 取代。

把此 Date 物件的小時設置為指定值。修改此 Date 物件，以便它用與以前一樣的年份、月份、日期、分鐘和秒表示某一天指定小時中的時間點（用本地時區進行解釋）。

參數：

hours - 小時值。

另請參見：

Calendar

getMinutes

@Deprecated
public int getMinutes()

已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.MINUTE) 取代。

返回此日期所表示的小時已經過去的分鐘數（用本地時區進行解釋）。返回值在 0 和 59 之間。

返回：

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

另請參見：

Calendar

setMinutes

@Deprecated
public void setMinutes(int minutes)

已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.MINUTE, int minutes) 取代。

把此 Date 物件的分鐘數設置為指定值。修改此 Date 物件，以便它用與以前一樣的年份、月份、日期、小時和秒表示小時的指定分鐘中的時間點（用本地時區進行解釋）。

參數：

minutes - 分鐘值。

另請參見：

Calendar

getSeconds

@Deprecated
public int getSeconds()

已過時。 從 JDK 1.1 開始，由 Calendar.get(Calendar.SECOND) 取代。

返回此日期所表示的分鐘已經過去的秒數。返回的值在 0 和 61 之間。值 60 和 61 只可能發生在考慮了閏秒的 Java 虛擬機器上。

返回：

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

另請參見：

Calendar

setSeconds

@Deprecated
public void setSeconds(int seconds)

已過時。 從 JDK 1.1 開始，由 Calendar.set(Calendar.SECOND, int seconds) 取代。

把此 Date 的秒數設置為指定值。修改此 Date 物件，以便它用與以前一樣的年份、月份、日期、小時和分鐘表示分鐘的指定秒數中的時間點（用本地時區進行解釋）。

參數：

seconds - 秒數值。

另請參見：

Calendar

getTime

public long getTime()

返回自 1970 年 1 月 1 日 00:00:00 GMT 以來此 Date 物件表示的毫秒數。

返回：

自 1970 年 1 月 1 日 00:00:00 GMT 以來此日期表示的毫秒數。

setTime

public void setTime(long time)

設置此 Date 物件，以表示 1970 年 1 月 1 日 00:00:00 GMT 以後 time 毫秒的時間點。

參數：

time - 毫秒數。

before

public boolean before(Date when)

測試此日期是否在指定日期之前。

參數：

when - 日期。

返回：

當且僅當此 Date 物件表示的瞬間比 when 表示的瞬間早，才返回 true；否則返回 false。

拋出：

NullPointerException - 如果 when 為 null。

after

public boolean after(Date when)

測試此日期是否在指定日期之後。

參數：

when - 日期。

返回：

當且僅當此 Date 物件表示的瞬間比 when 表示的瞬間晚，才返回 true；否則返回 false。

拋出：

NullPointerException - 如果 when 為 null。

equals

public boolean equals(Object obj)

比較兩個日期的相等性。當且僅當參數不為 null，並且是一個表示與此物件相同的時間點（到毫秒）的 Date 物件時，結果才為 true。

因此，當且僅當 getTime 方法對於兩個 Date 物件返回相同的 long 值時，這兩個物件才是相等的。

覆寫：

類別 Object 中的 equals

參數：

obj - 要與之比較的物件。

返回：

如果物件相同，則返回 true；否則，返回 false。

另請參見：

getTime()

compareTo

public int compareTo(Date anotherDate)

比較兩個日期的順序。

指定者：

介面 Comparable<Date> 中的 compareTo

參數：

anotherDate - 要比較的 Date。

返回：

如果參數 Date 等於此 Date，則返回值 0；如果此 Date 在 Date 參數之前，則返回小於 0 的值；如果此 Date 在 Date 參數之後，則返回大於 0 的值。

拋出：

NullPointerException - 如果 anotherDate 為 null。

從以下版本開始：

1.2

hashCode

public int hashCode()

返回此物件的雜湊碼值。結果是 getTime() 方法返回的基本 long 值的兩部分的異或。也就是說，雜湊碼就是以下表達式的值：

(int)(this.getTime()^(this.getTime() >>> 32))

覆寫：

類別 Object 中的 hashCode

返回：

此物件的雜湊碼值。

另請參見：

Object.equals(java.lang.Object), Hashtable

toString

public String toString()

把此 Date 物件轉換為以下形式的 String：

 dow mon dd hh:mm:ss zzz yyyy

其中：

• dow 是一周中的某一天 (Sun, Mon, Tue, Wed, Thu, Fri, Sat)。
• mon 是月份 (Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec)。
• dd 是一月中的某一天（01 至 31），顯示為兩位十進制數。
• hh 是一天中的小時（00 至 23），顯示為兩位十進制數。
• mm 是小時中的分鐘（00 至 59），顯示為兩位十進制數。
• ss 是分鐘中的秒數（00 至 61），顯示為兩位十進制數。
• zzz 是時區（並可以反映夏令時）。標準時區縮寫包括方法 parse 識別的時區縮寫。如果不提供時區資訊，則 zzz 為空，即根本不包括任何字元。
• yyyy 是年份，顯示為 4 位十進制數。

覆寫：

類別 Object 中的 toString

返回：

此日期的字元串表示形式。

另請參見：

toLocaleString(), toGMTString()

toLocaleString

@Deprecated
public String toLocaleString()

已過時。 從 JDK 1.1 開始，由 DateFormat.format(Date date) 取代。

以與實作相關的方式創建此 Date 物件的字元串表示形式。其目的是這種形式應該為所有 Java 應用程序的使用者所熟悉，而不管它運行在何處。它類似於 ISO C 的 strftime() 函數支持的 "%c" 格式。

返回：

此日期的字元串表示形式（使用語言環境約定）。

另請參見：

DateFormat, toString(), toGMTString()

toGMTString

@Deprecated
public String toGMTString()

已過時。 從 JDK 1.1 開始，由 DateFormat.format(Date date) 取代，使用 GMT TimeZone。

創建此 Date 物件的字元串表示形式，如下： d mon yyyy hh:mm:ss GMT 其中：

• d 是一月中的某一天（1 至 31），顯示為一位或兩位十進制數。
• mon 是月份 (Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec)。
• yyyy 是年份，顯示為 4 位十進制數。
• hh 是一天中的小時（00 至 23），顯示為兩位進制數。
• mm 是小時中的分鐘（00 至 59），顯示為兩位十進制數。
• ss 分鐘中的秒數（00 至 61），顯示為兩位十進制數。
• GMT 就是 ASCII 字母 "GMT"，代表格林威治標準時 (Greenwich Mean Time)。

結果不依賴於本地時區。

返回：

此日期的字元串表示形式（使用 Internet GMT 約定）。

另請參見：

DateFormat, toString(), toLocaleString()

getTimezoneOffset

@Deprecated
public int getTimezoneOffset()

已過時。 從 JDK 1.1 開始，由 -(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000) 取代。

返回相對於 UTC（相應於此 Date 物件表示的時間）的本地時區的偏移量（以分鐘為單位）。

例如，在馬薩諸塞州，比格林威治時間晚 5 個時區：

new Date(96, 1, 14).getTimezoneOffset() 返回 300

因為在 1996 年 2 月 14 日，使用標準時間（東部標準時間），此時間和 UTC 有 5 小時的偏移量；但是：

new Date(96, 5, 1).getTimezoneOffset() 返回 240

因為在 1996 年 6 月 1 日，使用夏令時（東部日光時間），此時間和 UTC 只有 4 小時的偏移量。

此方法產生與以下計算方式相同的結果：

 (this.getTime() - UTC(this.getYear(), 
                       this.getMonth(), 
                       this.getDate(),
                       this.getHours(), 
                       this.getMinutes(), 
                       this.getSeconds())) / (60 * 1000)
 

返回：

當前時區的時區偏移量（以分鐘為單位）。

另請參見：

Calendar.ZONE_OFFSET, Calendar.DST_OFFSET, TimeZone.getDefault()