Year.Until(ITemporal, ITemporalUnit) Metodo
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.
Calcola la quantità di tempo fino a un altro anno in termini di unità specificata.
[Android.Runtime.Register("until", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/TemporalUnit;)J", "", ApiSince=26)]
public long Until(Java.Time.Temporal.ITemporal? endExclusive, Java.Time.Temporal.ITemporalUnit? unit);
[<Android.Runtime.Register("until", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/TemporalUnit;)J", "", ApiSince=26)>]
abstract member Until : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporalUnit -> int64
override this.Until : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporalUnit -> int64
Parametri
- endExclusive
- ITemporal
la data di fine, esclusiva, che viene convertita in un anno, non null
- unit
- ITemporalUnit
unità in cui misurare l'importo, non null
Valori restituiti
la quantità di tempo tra quest'anno e l'anno di fine
Implementazioni
- Attributi
Commenti
Calcola la quantità di tempo fino a un altro anno in termini di unità specificata. In questo modo viene calcolato l'intervallo di tempo tra due oggetti Year in termini di un singolo oggetto TemporalUnit. I punti di inizio e fine sono questo e l'anno specificato. Il risultato sarà negativo se la fine è prima dell'inizio. Il valore Temporale passato a questo metodo viene convertito in un oggetto Year usando from(TemporalAccessor). Ad esempio, l'importo tra decenni tra due anni può essere calcolato usando startYear.until(endYear, DECADES). Il calcolo restituisce un numero intero, che rappresenta il numero di unità complete tra i due anni. Ad esempio, l'importo tra decenni tra il 2012 e il 2031 sarà solo un decennio perché è un anno breve di due decenni. Esistono due modi equivalenti per usare questo metodo. Il primo consiste nel richiamare questo metodo. Il secondo consiste nell'usare TemporalUnit.between(Temporal, Temporal): la scelta deve essere effettuata in base alla quale il codice risulta più leggibile. Il calcolo viene implementato in questo metodo per ChronoUnit. Sono supportate le unità YEARS, DECADES, CENTURY, MILLENNIA ed ERAS. Altri valori ChronoUnit genereranno un'eccezione. Se l'unità non è chronounit, il risultato di questo metodo viene ottenuto richiamando TemporalUnit.between(Temporale, Temporale) passando questo come primo argomento e il valore temporale di input convertito come secondo argomento. Questa istanza non è modificabile e non influenzata da questa chiamata al metodo.
Java informazioni di riferimento per java.time.Year.until.