ITemporal 介面

參考

定義

命名空間:: Java.Time.Temporal

組件:: Mono.Android.dll

重要

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

定義時態物件讀寫存取權的架構層級介面，例如日期、時間、位移或其中一些組合。

[Android.Runtime.Register("java/time/temporal/Temporal", "", "Java.Time.Temporal.ITemporalInvoker", ApiSince=26)]
public interface ITemporal : IDisposable, Java.Interop.IJavaPeerable, Java.Time.Temporal.ITemporalAccessor

[<Android.Runtime.Register("java/time/temporal/Temporal", "", "Java.Time.Temporal.ITemporalInvoker", ApiSince=26)>]
type ITemporal = interface
    interface ITemporalAccessor
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

衍生: Java.Time.Chrono.IChronoLocalDate

Java.Time.Chrono.IChronoLocalDateTime

Java.Time.Chrono.IChronoZonedDateTime

Java.Time.Instant

Java.Time.LocalDate

更多…

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable ITemporalAccessor IDisposable

備註

定義時態物件讀寫存取權的架構層級介面，例如日期、時間、位移或其中一些組合。

這是日期、時間和位移物件的基底介面類型，這些對象已足夠完整，可以使用加號和減號來操作。它是由那些類別所實作，這些類別可以提供和操作資訊做為 TemporalField 欄位或 TemporalQuery 查詢。如需此介面的唯讀版本，請參閱 TemporalAccessor 。

大部分的日期和時間資訊都可以以數位表示。這些是使用 TemporalField 搭配使用 long 保存的數位來建立模型，以處理大型值。年、月和月數是字段的簡單範例，但也包含即時和位移。如需標準欄位集，請參閱 ChronoField 。

兩個日期/時間資訊不能以數位、java.time.chrono.Chronology chronology 和 java.time.ZoneId 時區來表示。您可以使用上TemporalQuery定義的靜態方法來存取#query(TemporalQuery) queries這些方法。

這個介面是架構層級的介面，不應該在應用程式程式代碼中廣泛使用。相反地，應用程式應該建立並傳遞具體類型的實體，例如 LocalDate。有許多原因，其中一部分是這個介面的實作可能位於ISO以外的行事曆系統中。如需問題的完整討論，請參閱 java.time.chrono.ChronoLocalDate 。

如果類別符合三個準則，則類別應該實作這個介面：<ul<>li 會提供日期/時間/位移資訊的存取權，因為根據<TemporalAccessor li>>，一組字段是連續的，從最大到最小的 <li>，欄位集已完成，因此不需要其他欄位來定義代表 </ul 之字段的有效值範圍>

四個範例清楚說明： <ul><li>LocalDate 會實作這個介面，因為它代表一組連續的欄位，這些欄位會從天到永遠連續，而且不需要外部資訊來判斷每個日期的有效性。因此，它能夠正確實作加號/減號。 <li>LocalTime 會實作這個介面，因為它代表一組連續從 nanos 到天數內且不需要外部資訊來判斷有效性的字段。它能夠正確實作加號/減號，方法是在一天四處換行。 <li>MonthDay，年月和月日的組合，不會實作這個介面。雖然組合是連續的，從數天到數年內的月數，但組合沒有足夠的資訊來定義一天的有效值範圍。因此，無法正確實作加號/減號。 <li>組合一周和一天（“星期五十三”）不應該實作這個介面。它不代表連續的欄位集，因為天數到周會重迭天數到月份。 </ul>

已在1.8中新增。

的 java.time.temporal.TemporalJava 檔。

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

屬性

Handle	取得基礎 Android 物件的 JNI 值。 (繼承來源 IJavaObject)
JniIdentityHashCode	傳回包裝實例的值 `java.lang.System.identityHashCode()` 。 (繼承來源 IJavaPeerable)
JniManagedPeerState	受控對等的狀態。 (繼承來源 IJavaPeerable)
JniPeerMembers	成員存取和調用支援。 (繼承來源 IJavaPeerable)
PeerReference	傳 JniObjectReference 回已包裝 Java 物件實例的。 (繼承來源 IJavaPeerable)

方法

Disposed()	處置實例時呼叫。 (繼承來源 IJavaPeerable)
DisposeUnlessReferenced()	如果這個實例沒有未完成的參考，則呼叫 `Dispose()`，否則不會執行任何動作。 (繼承來源 IJavaPeerable)
Finalized()	實例完成時呼叫。 (繼承來源 IJavaPeerable)
Get(ITemporalField)	取得指定欄位的值做為 `int`。 (繼承來源 ITemporalAccessor)
GetLong(ITemporalField)	取得指定欄位的值做為 `long`。 (繼承來源 ITemporalAccessor)
IsSupported(ITemporalField)	檢查指定的欄位是否受到支援。 (繼承來源 ITemporalAccessor)
IsSupported(ITemporalUnit)	檢查指定的單位是否受到支援。
Minus(Int64, ITemporalUnit)	傳回與這個物件相同的型別物件，並減去指定的句點。
Minus(ITemporalAmount)	傳回與這個物件相同類型的物件，其數量會減去。
Plus(Int64, ITemporalUnit)	傳回與這個物件相同的型別物件，並加入指定的句點。
Plus(ITemporalAmount)	傳回與這個物件具有相同類型的物件，並加入數量。
Query(ITemporalQuery)	查詢此日期時間。 (繼承來源 ITemporalAccessor)
Range(ITemporalField)	取得指定欄位的有效值範圍。 (繼承來源 ITemporalAccessor)
SetJniIdentityHashCode(Int32)	設定所 `JniIdentityHashCode`傳回的值。 (繼承來源 IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	定義時態物件讀寫存取權的架構層級介面，例如日期、時間、位移或其中一些組合。 (繼承來源 IJavaPeerable)
SetPeerReference(JniObjectReference)	設定所 `PeerReference`傳回的值。 (繼承來源 IJavaPeerable)
UnregisterFromRuntime()	取消註冊此實例，讓運行時間不會從未來的 Java.Interop.JniRuntime+JniValueManager.PeekValue 調用傳回它。 (繼承來源 IJavaPeerable)
Until(ITemporal, ITemporalUnit)	根據指定的單位計算另一個時態性的時間量。
With(ITemporalAdjuster)	傳回與這個物件相同的型別調整物件，並進行調整。
With(ITemporalField, Int64)	傳回與這個物件相同的型別物件，並改變指定的欄位。

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	定義時態物件讀寫存取權的架構層級介面，例如日期、時間、位移或其中一些組合。
GetJniTypeName(IJavaPeerable)	定義時態物件讀寫存取權的架構層級介面，例如日期、時間、位移或其中一些組合。

適用於

共用方式為

ITemporal 介面

定義

備註

屬性

方法

擴充方法

適用於

其他資源