Date 類別

定義

命名空間:: Java.Util

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

類別以 Date 毫秒級的精度代表特定時間點。

[Android.Runtime.Register("java/util/Date", DoNotGenerateAcw=true)]
public class Date : Java.Lang.Object, IDisposable, 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

JavaObject

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中會根據需要加入閏秒，以使UTC與UT1相差0.9秒以內，UT1是帶有特定修正的UT版本。還有其他時間和日期系統;例如，衛星全球定位系統（GPS）所用的時間尺度與UTC同步，但未調整閏秒。一個有趣的進一步資訊來源是美國海軍天文台（USNO）：<引用>

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

</區塊引用>

以及關於「時間系統」的資料，請見： <引用區塊>

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

</區塊引用>

該系統描述了包括UT、UT1和UTC等多種時間系統。

在所有接受或回傳年份、月份、日期、小時、分鐘和秒值的類別 Date 方法中，會使用以下表示方式： <ul><li>a year y 以整數 y - 1900 表示。 <li>月份由整數表示，從0到11;0為一月，1為二月，依此類推;因此11為十二月。 <li>日期（月份的日期）以1到31的整數表示，方式如常。 <li>一小時由 0 到 23 的整數表示。因此，午夜至凌晨1點為第0小時，中午至下午1點為第12小時。 <li>一分鐘以0至59的整數表示，方式與一般相同。 <li>一秒以 0 到 61 的整數表示;60 和 61 這兩個值只會出現在閏秒時，且僅在真正正確追蹤閏秒的 Java 實作中出現。由於目前閏秒的引入方式，兩跳秒在同一分鐘內發生的可能性極低，但此規範遵循 ISO C 的日期與時間慣例。 </ul>

在所有情況下，為這些目的所給予的方法論證不必落在所示範圍內;例如，某日期可能被指定為1月32日，並被解釋為2月1日。

1.0 版本新增。

的 java.util.DateJava 檔。

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

建構函式

名稱	Description
Date()	分配一個 `Date` 物件並初始化，使其代表分配的時間，精確到最接近的毫秒。
Date(Int32, Int32, Int32, Int32, Int32, Int32)	已淘汰. 分配一個`Date`物件並初始化，使其代表由 `year`、 `month`、 `datehrsminsec` 、和參數在當地時區指定的秒起點。
Date(Int32, Int32, Int32, Int32, Int32)	已淘汰. 分配一個`Date`物件並初始化，使其代表由 `year`、 `month`、 `datehrsmin` 及參數指定的分鐘開始時刻，且在當地時區內。
Date(Int32, Int32, Int32)	已淘汰. 分配一個`Date`物件並初始化，使其代表由、 `year`、 `month` 及參數指定的`date`午夜（當地時間）開始。
Date(Int64)	分配一個 `Date` 物件並初始化為自標準基準時間「紀元」以來的指定毫秒數，即 1970 年 1 月 1 日 00：00：00 GMT。
Date(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。
Date(String)	已淘汰. 分配一個 `Date` 物件並初始化，使其代表字串所指示的日期與時間，該字串 `s`被解讀為 `Date#parse` 該方法。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Day	已淘汰. 返回以該日期表示的星期幾。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
Hours	已淘汰. 返回由該 `Date` 物件所代表的時。 -或- 將該 `Date` 物件的時間設定為指定的值。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	類別以 `Date` 毫秒級的精度代表特定時間點。 (繼承來源 JavaObject)
JniPeerMembers	類別以 `Date` 毫秒級的精度代表特定時間點。
Minutes	已淘汰. 回傳該日期所代表的超過小時的分鐘數，依當地時區的解釋。 -或- 將此 `Date` 物件的分鐘數設定為指定值。
Month	已淘汰. 回傳一個代表包含或以該物件所代表 `Date` 時間點開始的月份的數字。 -或- 將該日期的月份設定為指定的值。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Seconds	已淘汰. 回傳該日期所代表的分鐘後的秒數。 -或- 將秒 `Date` 數設定為指定值。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
Time	回傳自 1970 年 1 月 1 日 00：00：00 GMT 以來，由此 `Date` 物件所代表的毫秒數。 -或- 將此 `Date` 物件設定為1970年1月1日00：00：00 GMT後毫秒的某個時間 `time` 點。
TimezoneOffset	已淘汰. 回傳相對於UTC的當地時區偏移量（以分鐘計），該偏移量適用於該 `Date` 物件所代表的時間。
Year	已淘汰. 回傳一個值，是從包含或以該物件代表的時間點 `Date` 開始的年份減去1900後得出的值，該年份以當地時區為解讀方式。 -或- 將此 `Date` 物件的年份設定為指定的值加上1900年。

方法

名稱	Description
After(Date)	測試這個日期是否已經超過指定日期。
Before(Date)	測試該日期是否早於指定日期。
Clone()	回傳此物件的副本。
CompareTo(Date)	比較兩個訂購日期。
Construct(JniObjectReference, JniObjectReferenceOptions)	類別以 `Date` 毫秒級的精度代表特定時間點。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	類別以 `Date` 毫秒級的精度代表特定時間點。 (繼承來源 JavaObject)
Equals(Object)	類別以 `Date` 毫秒級的精度代表特定時間點。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
From(Instant)	從物件`Date`取得一個`Instant`實例。
GetDate()	已淘汰. 回傳此 `Date` 物件所代表的月份日期。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Parse(String)	已淘汰. 嘗試將字串 `s` 解讀為日期與時間的表示。
SetDate(Int32)	已淘汰. 將該 `Date` 物件的月份日期設為指定的值。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	類別以 `Date` 毫秒級的精度代表特定時間點。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToGMTString()	已淘汰. 建立此物件的字串表示 `Date` ，形式為： <blockquote>
ToInstant()	將此 `Date` 物件 `Instant`轉換為。
ToLocaleString()	已淘汰. 建立此 `Date` 物件的字串表示，且依實作而異。
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
UTC(Int32, Int32, Int32, Int32, Int32, Int32)	已淘汰. 根據論點決定日期和時間。
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IComparable.CompareTo(Object)	類別以 `Date` 毫秒級的精度代表特定時間點。
IJavaPeerable.Disposed()	類別以 `Date` 毫秒級的精度代表特定時間點。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	類別以 `Date` 毫秒級的精度代表特定時間點。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	類別以 `Date` 毫秒級的精度代表特定時間點。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	類別以 `Date` 毫秒級的精度代表特定時間點。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	類別以 `Date` 毫秒級的精度代表特定時間點。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	類別以 `Date` 毫秒級的精度代表特定時間點。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	類別以 `Date` 毫秒級的精度代表特定時間點。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	類別以 `Date` 毫秒級的精度代表特定時間點。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於