Date 類別

定義

類別 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
繼承
Date
衍生
屬性
實作

備註

類別 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秒,感謝新增的閏秒。 大部分的計算機時鐘都不夠精確,無法反映閏秒的差異。

有些計算機標準是以 Greenwich 平均時間 (GMT) 來定義,這相當於通用時間 (UT) 。 GMT 是標準的「公民」名稱;UT 是相同標準的「科學」名稱。 UTC 和 UT 之間的差異在於 UTC 是以不可部分完成的時鐘為基礎,而 UT 是以觀測為基礎,基於所有實際目的,這是一個不可見的細發來分割。 因為地球的旋轉不一致 (所以會以複雜的方式) 速度變慢並加速,所以 UT 不一定會一致地流動。 閏秒會視需要導入 UTC,以便在 UT1 的 0.9 秒內保留 UTC,這是套用特定更正的 UT 版本。 還有其他時間和日期系統;例如,衛星型全域定位系統所使用的時間刻度 (GPS) 會同步至UTC,但 不會 調整閏秒。 進一步資訊的有趣來源 美國 是 usNO ( () :<blockquote>

<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。

在接受或傳回 year、month、date、hours、minutes 和 seconds 值的所有類別 Date 方法中,會使用下列表示法: <ul><li>A year y 是以 integer y - 1900來表示。 <li>A month is represented by an integer from 0 to 11; 0 is January, 1 is January, 1 is February, so so 11 is December. <li>月 (日) 的日期會以一般方式以 1 到 31 的整數表示。 <li>An hour is represented by an integer from 0 to 23. 因此,從午夜到下午 1 點的小時是小時 0,而從下午到下午 1 點的小時是小時 12。 <li>A 分鐘會以一般方式以介於 0 到 59 的整數表示。 <li>A second 是以介於 0 到 61 之間的整數來表示;值 60 和 61 只會在閏秒發生,甚至只發生在實際追蹤閏秒的 Java 實作中。 由於目前引進閏秒的方式,極不可能在同一分鐘內發生兩個閏秒,但此規格遵循 ISO C 的日期和時間慣例。 </Ul>

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

已在1.0中新增。

java.util.DateJava 檔。

此頁面的部分是根據 所建立和共用的工作進行修改,並根據 2.5 屬性授權中所述的詞彙來使用。

建構函式

Date()

配置 Date 物件並初始化它,使其表示配置的時間,測量為最接近的毫秒。

Date(Int32, Int32, Int32)
已淘汰.

配置 Date 物件並初始化它,使其表示 、 和 date 自變數所yearmonth指定一天的午夜、當地時間。

Date(Int32, Int32, Int32, Int32, Int32)
已淘汰.

配置 Date 物件並初始化它,使其表示在本機時區中、monthdatehrsmin 自變數所year指定分鐘開頭的立即。

Date(Int32, Int32, Int32, Int32, Int32, Int32)
已淘汰.

配置 Date 物件並初始化它,使其表示在本機時區中、month、、hrsdateminsec 自變數所year指定之第二個開頭的瞬間。

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: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 代表具有毫秒精確度的特定實時時間。

適用於