ITemporalUnit.Between(ITemporal, ITemporal) 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 tra due oggetti temporali.
[Android.Runtime.Register("between", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/Temporal;)J", "GetBetween_Ljava_time_temporal_Temporal_Ljava_time_temporal_Temporal_Handler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)]
public long Between(Java.Time.Temporal.ITemporal? temporal1Inclusive, Java.Time.Temporal.ITemporal? temporal2Exclusive);
[<Android.Runtime.Register("between", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/Temporal;)J", "GetBetween_Ljava_time_temporal_Temporal_Ljava_time_temporal_Temporal_Handler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
abstract member Between : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporal -> int64
Parametri
- temporal1Inclusive
- ITemporal
oggetto temporale di base, non Null
- temporal2Exclusive
- ITemporal
l'altro oggetto temporale, esclusivo, non Null
Restituisce
quantità di tempo tra temporal1Inclusive e temporal2Exclusive in termini di questa unità; positivo se temporal2Exclusive è successivo a temporal1Inclusive, negativo se precedente
- Attributi
Commenti
Calcola la quantità di tempo tra due oggetti temporali.
In questo modo viene calcolato l'importo in termini di questa unità. I punti iniziale e finale vengono forniti come oggetti temporali e devono essere di tipi compatibili. L'implementazione convertirà il secondo tipo in un'istanza del primo tipo prima del calcolo dell'importo. Il risultato sarà negativo se la fine è prima dell'inizio. Ad esempio, la quantità in ore tra due oggetti temporali può essere calcolata usando HOURS.between(startTime, endTime)
.
Il calcolo restituisce un numero intero, che rappresenta il numero di unità complete tra i due valori temporali. Ad esempio, la quantità in ore comprese tra le ore 11:30 e 13:29 sarà solo un'ora perché è un minuto breve di due ore.
Esistono due modi equivalenti per usare questo metodo. Il primo consiste nel richiamare direttamente questo metodo. Il secondo consiste nell'usare Temporal#until(Temporal, TemporalUnit)
:
// these two lines are equivalent
between = thisUnit.between(start, end);
between = start.until(end, thisUnit);
La scelta deve essere effettuata in base alla quale il codice risulta più leggibile.
Ad esempio, questo metodo consente di calcolare il numero di giorni tra due date:
long daysBetween = DAYS.between(start, end);
// or alternatively
long daysBetween = start.until(end, DAYS);
Le implementazioni devono eseguire query o calcoli usando le unità disponibili in ChronoUnit
o i campi disponibili in ChronoField
. Se l'unità non è supportata, è necessario generare un'eccezione UnsupportedTemporalTypeException
. Le implementazioni non devono modificare gli oggetti temporali specificati.
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.