Linguaggio

Instant.Until(ITemporal, ITemporalUnit) Metodo

Definizione

Calcola la quantità di tempo fino a un altro istante 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

Temporale: la data di fine, esclusiva, che viene convertita in instant, non null

unit
ITemporalUnit

TemporalUnit: unità per misurare l'importo in, non null

Valori restituiti

la quantità di tempo tra questo istante e l'istante finale

Implementazioni

Attributi

Commenti

Calcola la quantità di tempo fino a un altro istante in termini di unità specificata. In questo modo viene calcolato l'intervallo di tempo tra due oggetti Instant in termini di un singolo oggetto TemporalUnit. I punti iniziale e finale sono questo e l'istante specificato. Il risultato sarà negativo se la fine è prima dell'inizio. Il calcolo restituisce un numero intero, che rappresenta il numero di unità complete tra i due istantanei. Il valore temporale passato a questo metodo viene convertito in un oggetto Instant using from(TemporalAccessor). Ad esempio, la quantità in secondi tra due date può essere calcolata usando startInstant.until(endInstant, SECONDS). 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à NANOS, MICROS, MILLIS, SECONDS, MINUTES, HOURS, HALF_DAYS e DAYS. 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.

Genera: ArithmeticException se si verifica un overflow numerico

Genera: DateTimeException se non è possibile calcolare l'importo o non è possibile convertire l'intervallo temporale di fine in un'istanza immediata

Throws: UnsupportedTemporalTypeException se l'unità non è supportata

Informazioni di riferimento su Android per java.time.Instant.until.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a