Duration 類別

定義

命名空間:: Java.Time

組件:: Mono.Android.dll

重要

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

以時間為基礎的時間，例如1934年。

[Android.Runtime.Register("java/time/Duration", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class Duration : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable, Java.Time.Temporal.ITemporalAmount

[<Android.Runtime.Register("java/time/Duration", ApiSince=26, DoNotGenerateAcw=true)>]
type Duration = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparable
    interface ITemporalAmount

繼承: Object

JavaObject

Object
Duration

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable ISerializable IComparable ITemporalAmount IDisposable

備註

以時間為基礎的時間，例如「34.5秒」。

這門課以秒和奈秒來模擬時間的量或長度。也可以使用其他基於時間的單位，如分鐘和小時來存取。此外，該 ChronoUnit#DAYS DAYS 裝置可被使用，且被視為24小時，因此忽略了夏令時間的影響。請參閱 Period 此類別的基於日期的對應物。

物理持續時間可以是無限長的。為了實用起見，時間的儲存條件與類似 Instant。該持續時間使用奈秒解析度，最大值為可保持 long的秒數。這比目前估計的宇宙年齡還要大。

持續時間的範圍需要儲存一個大於 long的數字。為達成此目的，類別儲存 long 一個代表秒的秒數與 int 一個代表的奈秒秒，兩者永遠介於 0 與 999,999,999 之間。該模型具有有向持續時間，意即持續時間可能是負的。

時間以「秒」為單位，但這些時間不一定與基於原子鐘的科學定義「SI秒」相同。此差異僅影響接近閏秒的持續時間，通常不會影響大多數應用。關於秒數意義及時間尺度的討論，請參見 Instant 相關討論。

新增於1.8版本。

Java 文件 java.time.Duration。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsNegative	檢查這個持續時間是否為負，排除零。
IsPositive	檢查此持續時間是否為正，排除零。
IsZero	檢查這個長度是否為零。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	以時間為基礎的時間，例如1934年。 (繼承來源 JavaObject)
JniPeerMembers	以時間為基礎的時間，例如1934年。
Nano	在此期間內，會計算每秒內的奈秒數。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Seconds	會獲得這段時間內的秒數。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
Units	取得由此持續時間支撐的單位集合。
Zero	以時間為基礎的時間，例如1934年。

方法

名稱	Description
Abs()	回傳一份長度為正的該時長副本。
AddTo(ITemporal)	將此持續時間加到指定的時間物件上。
Between(ITemporal, ITemporal)	獲得一個代表兩個時間物件間持續時間的持續時間。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
CompareTo(Duration)	將此持續時間與指定的持續時間做比較。
Construct(JniObjectReference, JniObjectReferenceOptions)	以時間為基礎的時間，例如1934年。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	以時間為基礎的時間，例如1934年。 (繼承來源 JavaObject)
DividedBy(Duration)	回傳指定持續時間在此期間內發生整數次。
DividedBy(Int64)	回傳一份該持續時間除以指定值的副本。
Equals(Object)	以時間為基礎的時間，例如1934年。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
From(ITemporalAmount)	從時間值獲得持續時間實例。
Get(ITemporalUnit)	取得所要求單位的價值。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Minus(Duration)	回傳一份相減後的存續時間副本。
Minus(Int64, ITemporalUnit)	回傳一份相減後的存續時間副本。
MinusDays(Int64)	回傳一份該期限的副本，並扣除標準24小時天的指定期限。
MinusHours(Int64)	回傳一份該持續時間的副本，並扣除指定的時數。
MinusMillis(Int64)	回傳一份以毫秒為單位減去指定持續時間的副本。
MinusMinutes(Int64)	回傳一份該時長的副本，並扣除指定的分鐘數。
MinusNanos(Int64)	回傳一份以奈秒為單位的指定持續時間的副本。
MinusSeconds(Int64)	回傳一份以秒為單位減去指定持續時間的副本。
MultipliedBy(Int64)	回傳該持續時間乘以標量的副本。
Negated()	回傳一份相同長度的副本，且長度被抵消。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Of(Int64, ITemporalUnit)	獲得代表指定單位金額的持續期間。
OfDays(Int64)	以時間為基礎的時間，例如1934年。
OfHours(Int64)	獲得代表若干標準小時數的持續時間。
OfMillis(Int64)	獲得代表數毫秒的持續時間。
OfMinutes(Int64)	獲得代表標準分鐘數的持續時間。
OfNanos(Int64)	獲得代表奈秒數的持續時間。
OfSeconds(Int64, Int64)	獲得代表秒數的持續時間及奈秒的調整。
OfSeconds(Int64)	獲得代表秒數的持續時間。
Parse(ICharSequence)	可從文字串如 PnDTnHnMn.nS 取得持續時間。
Parse(String)	以時間為基礎的時間，例如1934年。
Plus(Duration)	回傳一份包含指定持續時間的副本。
Plus(Int64, ITemporalUnit)	回傳一份包含指定持續時間的副本。
PlusDays(Int64)	回傳一份包含標準24小時天的指定期限副本。
PlusHours(Int64)	回傳一份該時長的副本，並加上指定的時長。
PlusMillis(Int64)	回傳一份該時長的副本，並加上指定時長（以毫秒為單位）。
PlusMinutes(Int64)	回傳一份該持續時間的副本，並加上指定的分鐘數。
PlusNanos(Int64)	回傳一份該持續時間的副本，並加上指定的奈秒持續時間。
PlusSeconds(Int64)	回傳一份該持續時間的副本，並加上指定的秒數。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	以時間為基礎的時間，例如1934年。 (繼承來源 JavaObject)
SubtractFrom(ITemporal)	從指定的時間物件中減去此持續時間。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToDays()	會取得這段期間內的天數。
ToDaysPart()	提取期間內的天數。
ToHours()	會取得這段期間的時數。
ToHoursPart()	從時數中提取時數。
ToMillis()	將此持續時間轉換為總長度（毫秒）。
ToMillisPart()	提取毫秒數，部分時間。
ToMinutes()	會取得這段時間內的分鐘數。
ToMinutesPart()	從長度中提取分鐘數部分。
ToNanos()	將此持續時間轉換為以奈秒為單位的總長度，表示為 `long`。
ToNanosPart()	在持續時間的幾秒內就取得奈秒的部分。
ToSeconds()	會獲得這段時間內的秒數。
ToSecondsPart()	從時間中提取秒數。
ToString()	回傳物件的字串表示。 (繼承來源 Object)
TruncatedTo(ITemporalUnit)	回傳一份截斷至指定單位的持續時間副本。
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
WithNanos(Int32)	回傳該時長的副本，並以指定的秒奈米為單位。
WithSeconds(Int64)	回傳一份包含指定秒數的持續時間副本。

明確介面實作

名稱	Description
IComparable.CompareTo(Object)	以時間為基礎的時間，例如1934年。
IJavaPeerable.Disposed()	以時間為基礎的時間，例如1934年。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	以時間為基礎的時間，例如1934年。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	以時間為基礎的時間，例如1934年。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	以時間為基礎的時間，例如1934年。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	以時間為基礎的時間，例如1934年。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	以時間為基礎的時間，例如1934年。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	以時間為基礎的時間，例如1934年。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	以時間為基礎的時間，例如1934年。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於