ITemporal Interfaccia
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Interfaccia a livello di framework che definisce l'accesso in lettura/scrittura a un oggetto temporale, ad esempio una data, un'ora, un offset o una combinazione di queste.
[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
- Derivato
- Attributi
- Implementazioni
Commenti
Interfaccia a livello di framework che definisce l'accesso in lettura/scrittura a un oggetto temporale, ad esempio una data, un'ora, un offset o una combinazione di queste.
Si tratta del tipo di interfaccia di base per gli oggetti data, ora e offset sufficienti per essere modificati utilizzando plus e meno. Viene implementato da tali classi che possono fornire e modificare informazioni come campi TemporalField o query TemporalQuery. Vedere TemporalAccessor
per la versione di sola lettura di questa interfaccia.
La maggior parte delle informazioni di data e ora può essere rappresentata come numero. Vengono modellati usando TemporalField
con il numero mantenuto usando un long
oggetto per gestire valori di grandi dimensioni. Year, month e day-of-month sono semplici esempi di campi, ma includono anche istantanee e offset. Vedere ChronoField
per il set standard di campi.
Due parti di informazioni di data/ora non possono essere rappresentate da numeri, la cronologia java.time.chrono.Chronologia e il fuso orario java.time.ZoneId. È possibile accedervi tramite #query(TemporalQuery) queries
i metodi statici definiti in TemporalQuery
.
Questa interfaccia è un'interfaccia a livello di framework che non deve essere ampiamente usata nel codice dell'applicazione. Le applicazioni devono invece creare e passare istanze di tipi concreti, ad esempio LocalDate
. Ci sono molti motivi per questo, parte di cui le implementazioni di questa interfaccia possono trovarsi in sistemi di calendario diversi da ISO. Vedere java.time.chrono.ChronoLocalDate
per una discussione più completa dei problemi.
<h2>Quando implementare</h2>
Una classe deve implementare questa interfaccia se soddisfa tre criteri: <ul><li>fornisce l'accesso alle informazioni di data/ora/offset, in<TemporalAccessor
base a li>il set di campi sono contigui dal più grande al più <piccolo li>il set di campi sono completi, in modo che non sia necessario alcun altro campo per definire l'intervallo valido di valori per i campi rappresentati </ul>
Quattro esempi rendono chiaro: <ul><li>LocalDate
implementa questa interfaccia perché rappresenta un set di campi contigui da giorni a sempre e non richiedono informazioni esterne per determinare la validità di ogni data. È quindi in grado di implementare correttamente plus/minus. <li>LocalTime
implementa questa interfaccia perché rappresenta un set di campi contigui da nano a entro giorni e non richiedono informazioni esterne per determinare la validità. È in grado di implementare correttamente plus/minus, eseguendo il wrapping intorno al giorno. <li>MonthDay
, la combinazione di mese dell'anno e giorno del mese, non implementa questa interfaccia. Mentre la combinazione è contigua, da giorni a mesi entro anni, la combinazione non dispone di informazioni sufficienti per definire l'intervallo valido di valori per il giorno del mese. Di conseguenza, non è possibile implementare correttamente plus/minus. <li>La combinazione giorno della settimana e giorno del mese ("venerdì il 13") non deve implementare questa interfaccia. Non rappresenta un set contiguo di campi, poiché i giorni alle settimane si sovrappongono ai giorni ai mesi. </ul>
Aggiunta nella versione 1.8.
Documentazione java per java.time.temporal.Temporal
.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.
Proprietà
Handle |
Ottiene il valore JNI dell'oggetto Android sottostante. (Ereditato da IJavaObject) |
JniIdentityHashCode |
Restituisce il valore di |
JniManagedPeerState |
Stato del peer gestito. (Ereditato da IJavaPeerable) |
JniPeerMembers |
Supporto per l'accesso ai membri e la chiamata. (Ereditato da IJavaPeerable) |
PeerReference |
Restituisce un JniObjectReference oggetto dell'istanza dell'oggetto Java di cui è stato eseguito il wrapping. (Ereditato da IJavaPeerable) |
Metodi
Disposed() |
Chiamato quando l'istanza è stata eliminata. (Ereditato da IJavaPeerable) |
DisposeUnlessReferenced() |
Se non sono presenti riferimenti in sospeso a questa istanza, chiama |
Finalized() |
Chiamato quando l'istanza è stata finalizzata. (Ereditato da IJavaPeerable) |
Get(ITemporalField) |
Ottiene il valore del campo specificato come oggetto |
GetLong(ITemporalField) |
Ottiene il valore del campo specificato come oggetto |
IsSupported(ITemporalField) |
Controlla se il campo specificato è supportato. (Ereditato da ITemporalAccessor) |
IsSupported(ITemporalUnit) |
Controlla se l'unità specificata è supportata. |
Minus(Int64, ITemporalUnit) |
Restituisce un oggetto dello stesso tipo di questo oggetto con il punto specificato sottratto. |
Minus(ITemporalAmount) |
Restituisce un oggetto dello stesso tipo di questo oggetto con una quantità sottratta. |
Plus(Int64, ITemporalUnit) |
Restituisce un oggetto dello stesso tipo dell'oggetto con il punto specificato aggiunto. |
Plus(ITemporalAmount) |
Restituisce un oggetto dello stesso tipo dell'oggetto con un importo aggiunto. |
Query(ITemporalQuery) |
Esegue una query su questa data e ora. (Ereditato da ITemporalAccessor) |
Range(ITemporalField) |
Ottiene l'intervallo di valori validi per il campo specificato. (Ereditato da ITemporalAccessor) |
SetJniIdentityHashCode(Int32) |
Impostare il valore restituito da |
SetJniManagedPeerState(JniManagedPeerStates) |
Interfaccia a livello di framework che definisce l'accesso in lettura/scrittura a un oggetto temporale, ad esempio una data, un'ora, un offset o una combinazione di queste. (Ereditato da IJavaPeerable) |
SetPeerReference(JniObjectReference) |
Impostare il valore restituito da |
UnregisterFromRuntime() |
Annullare la registrazione di questa istanza in modo che il runtime non lo restituisca dalle chiamate future Java.Interop.JniRuntime+JniValueManager.PeekValue . (Ereditato da IJavaPeerable) |
Until(ITemporal, ITemporalUnit) |
Calcola la quantità di tempo fino a un altro intervallo temporale in termini di unità specificata. |
With(ITemporalAdjuster) |
Restituisce un oggetto regolato dello stesso tipo dell'oggetto con la regolazione effettuata. |
With(ITemporalField, Int64) |
Restituisce un oggetto dello stesso tipo di questo oggetto con il campo specificato modificato. |
Metodi di estensione
JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
JavaCast<TResult>(IJavaObject) |
Interfaccia a livello di framework che definisce l'accesso in lettura/scrittura a un oggetto temporale, ad esempio una data, un'ora, un offset o una combinazione di queste. |
GetJniTypeName(IJavaPeerable) |
Interfaccia a livello di framework che definisce l'accesso in lettura/scrittura a un oggetto temporale, ad esempio una data, un'ora, un offset o una combinazione di queste. |