Date 類別

定義

命名空間:

Java.Util

組件:

Mono.Android.dll

類別 Date 代表具有毫秒精確度的特定實時時間。

[Android.Runtime.Register("java/util/Date", DoNotGenerateAcw=true)]
public class Date : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Lang.IComparable

[<Android.Runtime.Register("java/util/Date", DoNotGenerateAcw=true)>]
type Date = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICloneable
    interface IComparable

繼承

Object

Object

Date

衍生

Java.Sql.Date

Java.Sql.Time

Java.Sql.Timestamp

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ISerializable ICloneable IComparable IDisposable

備註

類別 Date 代表具有毫秒精確度的特定實時時間。

在 JDK  之前;1.1，類別 Date 有兩個額外的函式。 它允許將日期解譯為年、月、日、小時、分鐘和秒值。 它也允許格式化和剖析日期字串。 不幸的是，這些函式的 API 無法進行國際化。 截至 JDK 1.1，類別 Calendar 應該用來在日期和時間欄位之間轉換，而 DateFormat 類別應該用來格式化和剖析日期字串。 中的 Date 對應方法已被取代。

雖然 類別 Date 旨在反映國際標準時間 （UTC），但可能不完全根據 Java 虛擬機的主機環境執行此動作。 幾乎所有的新式操作系統都假設為 1 day = 24 × 60 × 在所有情況下，60 = 86400 秒。 然而，在UTC中，大約每年或兩次會有一個額外的秒，稱為“閏秒”。 閏秒一律會新增為當天的最後一秒，且一律在 12 月 31 日或 6 月 30 日。 例如，1995 年的最後一分鐘長 61 秒，這要歸功於增加的閏秒。 大部分的計算機時鐘不夠準確，無法反映閏秒的區別。

有些計算機標準是以格林威治標準（GMT）來定義，相當於通用時間（UT）。 GMT 是標準的「民事」名稱;UT 是相同標準的「科學」名稱。 UTC 與 UT 之間的差異在於 UTC 是以原子時鐘為基礎，而 UT 是以天文觀測為基礎，基於所有實際目的，這是一個微不足道的細發分裂。 由於地球的旋轉不統一（它以複雜的方式減緩和加速），所以UT並不總是統一流動。 閏秒會視需要引入UTC，以便在UT1的0.9秒內保留UTC，這是套用特定更正的UT版本。 還有其他時間和日期系統;例如，衛星型全球定位系統（GPS）所使用的時間刻度會同步處理至UTC，但 不會 調整閏秒。 一個有趣的進一步資訊來源是 美國 海軍天文臺（USNO）：<區塊>

<a href="http://www.usno.navy.mil/USNO">http://www.usno.navy.mil/USNO</a>

</blockquote>

以及有關「時間系統」的材料： <blockquote>

<a href="http://www.usno.navy.mil/USNO/time/master-clock/systems-of-time">http://www.usno.navy.mil/USNO/time/master-clock/systems-of-time</a>

</blockquote>

其中包含各種不同時間系統的描述，包括UT、UT1和UTC。

在接受或傳回年份、月、日期、小時、分鐘和秒值的所有類別 Date 方法中，會使用下列表示法： <ul><li>A year y 是以整數 y  代表- 1900。 <li>A 月是以 0 到 11 的整數表示;0 是 1 月，1 是 2 月，依此類推;因此 11 是 12 月。 <li>A date （月的日） 以一般方式以 1 到 31 的整數表示。 <li>An hour 是以 0 到 23 的整數表示。 因此，從午夜到淩晨1點的小時是0小時，從中午到下午1點的小時是12小時。 <li>A 分鐘以一般方式以 0 到 59 的整數表示。 <li>A 秒是以從 0 到 61 的整數表示;值 60 和 61 只會在閏秒發生，甚至只會在實際追蹤閏秒的 Java 實作中發生。 由於目前引進了閏秒的方式，因此在相同分鐘內將發生兩個閏秒的可能性極小，但此規格遵循 ISO C 的日期和時間慣例。 </ul>

在所有情況下，針對這些用途提供給方法的自變數不需要落在指定的範圍內;例如，日期可以指定為 1 月 32 日，並解譯為意謂 2 月 1 日。

已在1.0中新增。

的 java.util.DateJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

Date()	配置 Date 物件並初始化它，使其表示配置的時間，測量為最接近的毫秒。
Date(Int32, Int32, Int32)	已淘汰. 配置 Date 物件並初始化物件，使其表示 、、 和 date 自變數所yearmonth指定之一天的午夜、當地時間。
Date(Int32, Int32, Int32, Int32, Int32)	已淘汰. 配置 Date 物件並初始化它，使其表示在本機時區中year由 、month、 datehrs和 min 自變數指定的分鐘開頭的瞬間。
Date(Int32, Int32, Int32, Int32, Int32, Int32)	已淘汰. 配置 Date 物件並初始化它，使其表示在本機時區中 year、 month、 date、 hrs、 min和 sec 自變數所指定之第二個開始的瞬間。
Date(Int64)	Date配置 物件並將它初始化，以表示自標準基底時間稱為 “epoch” 的指定毫秒數，也就是 1970 年 1 月 1 日 00：00：00 GMT。
Date(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。
Date(String)	已淘汰. 配置 Date 物件並初始化它，使其表示字串 所指示的日期和時間，這個字串 s會解譯為 方法 Date#parse 。

屬性

Class	傳回這個 Object的運行時間類別。 (繼承來源 Object)
Day	已淘汰. 傳回這個日期所代表的星期天。
Handle	基礎Android實例的句柄。 (繼承來源 Object)
Hours	已淘汰. 傳回這個 Date 物件所表示的小時。 -或- 將這個 Date 物件的小時設定為指定的值。
JniIdentityHashCode	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
JniPeerMembers	類別 Date 代表具有毫秒精確度的特定實時時間。
Minutes	已淘汰. 傳回此日期所表示之小時之後的分鐘數，如當地時區中解譯。 -或- 將這個 Date 物件的分鐘數設定為指定的值。
Month	已淘汰. 傳回數位，代表包含或以這個 Date 物件所表示之時間的瞬間開始的月份。 -或- 將這個日期的月份設定為指定的值。
PeerReference	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
Seconds	已淘汰. 傳回此日期所表示分鐘數的秒數。 -或- 將這個 Date 的秒數設定為指定的值。
ThresholdClass	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。
ThresholdType	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。
Time	傳回自 Date 1970 年 1 月 1 日 00：00：00 GMT 所代表的毫秒數。 -或- 將此物件設定 Date 為表示 1970 年 1 月 1 日 00：00：00 GMT 之後的毫秒時間 time 點。
TimezoneOffset	已淘汰. 傳回相對於UTC的當地時區，以分鐘為單位的位移，此時間適用於這個 Date 物件所代表的時間。
Year	已淘汰. 傳回值，該值是從包含或以這個 Date 物件所表示之時間的瞬間開始減去 1900 的結果，如當地時區所解譯。 -或- 將這個 Date 物件的年份設定為指定的值加上 1900。

方法

After(Date)	測試這個日期是否在指定的日期之後。
Before(Date)	測試這個日期是否在指定的日期之前。
Clone()	傳回這個 對象的複本。
CompareTo(Date)	比較兩個排序日期。
Dispose()	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
Dispose(Boolean)	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
From(Instant)	從物件取得的DateInstant實例。
GetDate()	已淘汰. 傳回這個 Date 物件所表示之月份的日期。
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	當垃圾收集決定不再參考物件時，垃圾收集行程在 物件上呼叫。 (繼承來源 Object)
Notify()	喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
Parse(String)	已淘汰. 嘗試將字串 s 解譯為日期和時間的表示。
SetDate(Int32)	已淘汰. 將這個 Date 物件的月份日期設定為指定的值。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
ToArray<T>()	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
ToGMTString()	已淘汰. 建立此 Date 物件的字串表示形式： <blockquote>
ToInstant()	將這個 Date 物件轉換成 Instant。
ToLocaleString()	已淘汰. 以實作相依的形式建立這個 Date 物件的字串表示。
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
UTC(Int32, Int32, Int32, Int32, Int32, Int32)	已淘汰. 根據自變數決定日期和時間。
Wait()	讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)

明確介面實作

IComparable.CompareTo(Object)	類別 Date 代表具有毫秒精確度的特定實時時間。
IJavaPeerable.Disposed()	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
IJavaPeerable.Finalized()	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	類別 Date 代表具有毫秒精確度的特定實時時間。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	類別 Date 代表具有毫秒精確度的特定實時時間。
GetJniTypeName(IJavaPeerable)	類別 Date 代表具有毫秒精確度的特定實時時間。