ITemporal インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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
- 派生
- 属性
- 実装
注釈
日付、時刻、オフセット、またはこれらの組み合わせなど、テンポラル オブジェクトへの読み取り/書き込みアクセスを定義するフレームワーク レベルのインターフェイス。
これは、日付、時刻、およびオフセット オブジェクトの基本インターフェイス型であり、正符号と負符号を使用して操作するのに十分です。 これは、TemporalField フィールドまたは TemporalQuery クエリとして情報を提供および操作できるクラスによって実装されます。 このインターフェイスの読み取り専用バージョンについては、 TemporalAccessor を参照してください。
ほとんどの日付と時刻の情報は数値として表すことができます。 これらは、大きな値を処理するためにlongを使用して保持されている数値を持つTemporalFieldを使用してモデル化されます。 年、月、日はフィールドの単純な例ですが、インスタントとオフセットも含まれます。 標準のフィールドセットについては、 ChronoField を参照してください。
2 つの日付/時刻情報は、java.time.chrono.Chronology の時系列と java.time.ZoneId タイム ゾーンの数値では表すことができません。 これらは、TemporalQueryで定義されている静的メソッドを使用して、#query(TemporalQuery) queries経由でアクセスできます。
このインターフェイスは、アプリケーション コードで広く使用すべきではないフレームワーク レベルのインターフェイスです。 代わりに、アプリケーションは、 LocalDateなどの具象型のインスタンスを作成して渡す必要があります。 これには多くの理由があり、その一部は、このインターフェイスの実装が ISO 以外のカレンダー システムにある可能性があることです。 問題の詳細については、 java.time.chrono.ChronoLocalDate を参照してください。
<h2>実装する場合</h2>
クラスは、3 つの条件を満たす場合にこのインターフェイスを実装する必要があります。 <ul><li>it は、 TemporalAccessor<li に従って日付/時刻/オフセット情報にアクセスできます>フィールドのセットは、最大から最小の <li まで連続しています>フィールドのセットは完全であるため、 </ul で表されるフィールドの有効な値の範囲を定義するために他のフィールドは必要ありません。>
4 つの例では、 <ul><li>LocalDate は、日から永遠に連続するフィールドのセットを表し、各日付の有効性を判断するために外部情報を必要としないため、このインターフェイスを実装します。 そのため、正しくプラス/マイナスを実装できます。
<li>LocalTime はこのインターフェイスを実装します。これは、ナノから数日以内に連続するフィールドのセットを表し、有効性を判断するために外部情報を必要としないためです。 1 日の周りを折り返すことで、正しくプラスマイナスを実装できます。
<li>MonthDay、月と日の組み合わせは、このインターフェイスを実装していません。 この組み合わせは連続していますが、日数から年内の月まで、その組み合わせには、日単位の有効な値の範囲を定義するのに十分な情報がありません。 そのため、正しくプラス/マイナスを実装できません。
<li>曜日と曜日の組み合わせ ("Friday the 13th") はこのインターフェイスを実装しないでください。 日から週が日から月に重なるので、連続したフィールドのセットを表すわけではありません。
</ul>
1.8 で追加されました。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
プロパティ
| 名前 | 説明 |
|---|---|
| Handle |
基になる Android オブジェクトの JNI 値を取得します。 (継承元 IJavaObject) |
| JniIdentityHashCode |
ラップされたインスタンスの |
| JniManagedPeerState |
マネージド ピアの状態。 (継承元 IJavaPeerable) |
| JniObjectReferenceControlBlock |
日付、時刻、オフセット、またはこれらの組み合わせなど、テンポラル オブジェクトへの読み取り/書き込みアクセスを定義するフレームワーク レベルのインターフェイス。 (継承元 IJavaPeerable) |
| JniPeerMembers |
メンバー アクセスと呼び出しのサポート。 (継承元 IJavaPeerable) |
| PeerReference |
ラップされたJava オブジェクト インスタンスのJniObjectReferenceを返します。 (継承元 IJavaPeerable) |
メソッド
| 名前 | 説明 |
|---|---|
| Disposed() |
インスタンスが破棄されたときに呼び出されます。 (継承元 IJavaPeerable) |
| DisposeUnlessReferenced() |
このインスタンスへの未処理の参照がない場合は、 |
| Finalized() |
インスタンスが終了したときに呼び出されます。 (継承元 IJavaPeerable) |
| Get(ITemporalField) |
指定したフィールドの値を |
| GetLong(ITemporalField) |
指定したフィールドの値を |
| IsSupported(ITemporalField) |
指定したフィールドがサポートされているかどうかを確認します。 (継承元 ITemporalAccessor) |
| IsSupported(ITemporalUnit) |
指定したユニットがサポートされているかどうかを確認します。 |
| Minus(Int64, ITemporalUnit) |
指定した期間を減算した、このオブジェクトと同じ型のオブジェクトを返します。 |
| Minus(ITemporalAmount) |
このオブジェクトと同じ型のオブジェクトを、減算した金額で返します。 |
| Plus(Int64, ITemporalUnit) |
指定した期間が追加された、このオブジェクトと同じ型のオブジェクトを返します。 |
| Plus(ITemporalAmount) |
金額が加算された、このオブジェクトと同じ型のオブジェクトを返します。 |
| Query(ITemporalQuery) |
この日時を照会します。 (継承元 ITemporalAccessor) |
| Range(ITemporalField) |
指定したフィールドの有効な値の範囲を取得します。 (継承元 ITemporalAccessor) |
| SetJniIdentityHashCode(Int32) |
|
| SetJniManagedPeerState(JniManagedPeerStates) |
日付、時刻、オフセット、またはこれらの組み合わせなど、テンポラル オブジェクトへの読み取り/書き込みアクセスを定義するフレームワーク レベルのインターフェイス。 (継承元 IJavaPeerable) |
| SetPeerReference(JniObjectReference) |
|
| UnregisterFromRuntime() |
ランタイムが将来の Java.Interop.JniRuntime+JniValueManager.PeekValue 呼び出しから返されないように、このインスタンスの登録を解除します。 (継承元 IJavaPeerable) |
| Until(ITemporal, ITemporalUnit) |
指定した単位の観点から別のテンポラルまでの時間を計算します。 |
| With(ITemporalAdjuster) |
このオブジェクトと同じ種類の調整済みオブジェクトを、調整が行われた状態で返します。 |
| With(ITemporalField, Int64) |
指定したフィールドが変更された、このオブジェクトと同じ型のオブジェクトを返します。 |
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
日付、時刻、オフセット、またはこれらの組み合わせなど、テンポラル オブジェクトへの読み取り/書き込みアクセスを定義するフレームワーク レベルのインターフェイス。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|