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 usando plus e meno. Viene implementato da queste 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. Questi valori vengono modellati usando con il numero mantenuto usando TemporalField
un long
oggetto per gestire valori di grandi dimensioni. Year, month e day-of-month sono semplici esempi di campi, ma includono anche offset istantanei e. Vedere ChronoField
per il set standard di campi.
Non è possibile rappresentare due parti di informazioni di data/ora, la cronologia java.time.chrono.Chronologia e il fuso orario java.time.ZoneId. Questi possono essere accessibili tramite #query(TemporalQuery) queries
l'uso dei 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 è che 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, come per<TemporalAccessor
li>il set di campi sono contigui dal più grande al più <>piccolo il set di campi sono completi, in modo che nessun altro campo sia necessario 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/meno. <li>LocalTime
implementa questa interfaccia perché rappresenta un set di campi contigui da nanos a entro giorni e non richiedono informazioni esterne per determinare la validità. È in grado di implementare correttamente plus/meno, eseguendo il wrapping intorno al giorno. <li>MonthDay
, la combinazione di mese di anno e giorno del mese, non implementa questa interfaccia. Anche se 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 è in grado di implementare correttamente plus/meno. <li>La combinazione day-of-week e day-of-month ("Venerdì il 13°") non deve implementare questa interfaccia. Non rappresenta un set contiguo di campi, poiché i giorni a settimane si sovrappongono a mesi. </ul>
Aggiunta nella versione 1.8.
Documentazione Java per java.time.temporal.Temporal
.
Le parti di questa pagina sono modifiche in base al lavoro creato e condiviso dal Android Open Source e usato in base ai termini descritti nella .
Proprietà
Handle |
Ottiene il valore JNI dell'oggetto Android sottostante. (Ereditato da IJavaObject) |
JniIdentityHashCode |
Restituisce il valore di per |
JniManagedPeerState |
Stato del peer gestito. (Ereditato da IJavaPeerable) |
JniPeerMembers |
Supporto per l'accesso ai membri e la chiamata. (Ereditato da IJavaPeerable) |
PeerReference |
Restituisce un'istanza JniObjectReference dell'oggetto Java con 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 |
GetLong(ITemporalField) |
Ottiene il valore del campo specificato come |
IsSupported(ITemporalField) |
Verifica se il campo specificato è supportato. (Ereditato da ITemporalAccessor) |
IsSupported(ITemporalUnit) |
Verifica se l'unità specificata è supportata. |
Minus(Int64, ITemporalUnit) |
Restituisce un oggetto dello stesso tipo di questo oggetto con il periodo 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 di questo oggetto con il periodo specificato aggiunto. |
Plus(ITemporalAmount) |
Restituisce un oggetto dello stesso tipo di questo oggetto con una quantità aggiunta. |
Query(ITemporalQuery) |
Esegue query su questa data. (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 restituirà dalle chiamate future Java.Interop.JniRuntime+JniValueManager.PeekValue . (Ereditato da IJavaPeerable) |
Until(ITemporal, ITemporalUnit) |
Calcola la quantità di tempo fino a quando un'altra dimensione temporale in termini di unità specificata. |
With(ITemporalAdjuster) |
Restituisce un oggetto modificato dello stesso tipo di questo 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 dei tipi controllati 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. |