Duration 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。
[Android.Runtime.Register("javax/xml/datatype/Duration", DoNotGenerateAcw=true)]
public abstract class Duration : Java.Lang.Object[<Android.Runtime.Register("javax/xml/datatype/Duration", DoNotGenerateAcw=true)>]
type Duration = class
inherit Object- 繼承
- 屬性
備註
W3C XML 架構 1.0 規格中所定義之時間範圍的不可變表示法。
Duration 物件代表公曆時間的期間，其中包含六個字段 (年、月、天、小時、分鐘和秒) 加上符號 (+/-) 字段。
前五個字段具有非負數 (>=0) 整數或 null (，代表字段未設定) ，而秒字段則為非負數十進制或 null。 負號表示負數持續時間。
這個類別提供許多方法，可讓您輕鬆地使用 XML 架構 1.0 的持續時間數據類型與 errata。
<h2>Order relationship</h2>
Duration 物件只有部分順序，其中兩個值 A 和 B 可能是：
<ol><li>A<B (A 短於 B) li>A&<gt;B (A 比 B) li>A==B (<A 和 B 的持續時間相同，) <li>A<>B (A 與 B 之間的比較不確定) </ol>
例如，相較於一個月，30 天不能有意義。 方法 #compare(Duration duration) 會實作這個關聯性。
#isLongerThan(Duration)如需物件間Duration順序關聯性的詳細資訊，請參閱 方法。
<h2>持續時間</h2 的作業>
這個類別提供一組基本的算術運算，例如加法、減法和乘法。 由於持續時間沒有總順序，因此某些作業組合的作業可能會失敗。 例如，您無法從 1 個月減去 15 天。 如需可能發生此情況的詳細狀況，請參閱這些方法的javadoc。
此外，不會提供以數位除法的持續時間，因為 Duration 類別只能處理有限的有效位數十進位數。 例如，一個不能代表 1 秒除以 3。
不過，您可以將除以 3 取代為乘以數位，例如 0.3 或 0.333。
<h2>允許值<的範圍/h2>
因為某些作業 Duration 會依賴 Calendar ，即使 Duration 可以保存非常大或非常小的值，某些方法可能無法正確運作 Duration。 受影響的方法會記錄其相 Calendar依性。
在 1.5 中新增。
的 javax.xml.datatype.DurationJava 檔。
此頁面的部分是根據 所建立和共用的工作進行修改，並根據 2.5 屬性授權中所述的詞彙來使用。
建構函式
| Duration() | |
| Duration(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
屬性
| Class |
傳回這個 |
| Days |
取得 DAYS 欄位的值做為整數值，如果沒有，則為 0。 |
| Handle |
基礎Android實例的句柄。 (繼承來源 Object) |
| Hours |
取得 HOURS 欄位的值做為整數值，如果沒有，則為 0。 |
| JniIdentityHashCode |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| JniPeerMembers |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 |
| Minutes |
取得 MINUTES 欄位的值做為整數值，如果沒有，則為 0。 |
| Months |
取得 MONTHS 欄位的值做為整數值，如果沒有，則為 0。 |
| PeerReference |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| Seconds |
取得 SECONDS 欄位的值做為整數值，如果沒有，則為 0。 |
| Sign |
傳回 -1,0 或 1 中此持續時間的符號。 |
| ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 |
| ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 |
| XMLSchemaType |
傳回這個實例所對應之 XML 架構日期/時間類型的名稱。 |
| Years |
取得這個 |
方法
| Add(Duration) |
計算其值為 |
| AddTo(Calendar) |
將此持續時間新增至 |
| AddTo(Date) |
將此持續時間新增至 |
| Clone() |
建立並傳回這個 對象的複本。 (繼承來源 Object) |
| Compare(Duration) |
此 |
| Dispose() |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| Dispose(Boolean) |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
| GetField(DatatypeConstants+Field) |
取得欄位的值。 |
| GetHashCode() |
傳回與 equals 方法定義一致的哈希程式代碼。 |
| GetTimeInMillis(Calendar) |
以毫秒為單位傳回持續時間的長度。 |
| GetTimeInMillis(Date) |
以毫秒為單位傳回持續時間的長度。 |
| IsLongerThan(Duration) |
檢查這個 duration 物件是否嚴格超過另一個 |
| IsSet(DatatypeConstants+Field) |
檢查欄位是否已設定。 |
| IsShorterThan(Duration) |
檢查這個 duration 物件是否嚴格小於另一個 |
| JavaFinalize() |
當垃圾收集判斷物件不再參考物件時，垃圾收集行程會在物件上呼叫。 (繼承來源 Object) |
| Multiply(BigDecimal) |
計算新的持續時間，其值為 |
| Multiply(Int32) |
計算新的持續時間，其值為 |
| Negate() |
傳回新的 |
| NormalizeWith(Calendar) |
使用特定時間立即作為參考點，將年份和月份欄位轉換成 days 欄位。 |
| Notify() |
喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object) |
| NotifyAll() |
喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| Subtract(Duration) |
計算其值為 |
| ToArray<T>() |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| 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) |
明確介面實作
| IJavaPeerable.Disposed() |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| IJavaPeerable.Finalized() |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| IJavaPeerable.JniManagedPeerState |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 (繼承來源 Object) |
擴充方法
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
| JavaCast<TResult>(IJavaObject) |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 |
| GetJniTypeName(IJavaPeerable) |
W3C XML 架構 1 中所定義之時間範圍的不可變表示法。 |