Sprache

Instant.Until(ITemporal, ITemporalUnit) Methode

Definition

Berechnet die Zeitspanne, bis eine andere Instanz in Bezug auf die angegebene Einheit erfolgt.

[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

Parameter

endExclusive
ITemporal

Zeitlich: Das Enddatum, exklusiv, das in einen Instant konvertiert wird, nicht null

unit
ITemporalUnit

TemporalUnit: Die Einheit, in der der Betrag gemessen werden soll, nicht NULL

Gibt zurück

die Zeitspanne zwischen diesem Sofortigen und dem End-Instant

Implementiert

Attribute

Hinweise

Berechnet die Zeitspanne, bis eine andere Instanz in Bezug auf die angegebene Einheit erfolgt. Dadurch wird die Zeitspanne zwischen zwei Instant-Objekten in Bezug auf eine einzelne TemporalUnit berechnet. Die Anfangs- und Endpunkte sind dies und die angegebene Instanz. Das Ergebnis wird negativ sein, wenn das Ende vor dem Start liegt. Die Berechnung gibt eine ganze Zahl zurück, die die Anzahl der vollständigen Einheiten zwischen den beiden Instants darstellt. Der an diese Methode übergebene Temporal wird in einen Instant using from(TemporalAccessor) konvertiert. Beispielsweise kann der Betrag in Sekunden zwischen zwei Datumsangaben mithilfe von "startInstant.until(endInstant, SECONDS) berechnet werden. Es gibt zwei äquivalente Methoden zur Verwendung dieser Methode. Die erste besteht darin, diese Methode aufzurufen. Die zweite ist die Verwendung von TemporalUnit.between(Temporal,Temporal): Die Wahl sollte auf der Grundlage getroffen werden, auf deren Grundlage der Code lesbarer wird. Die Berechnung wird in dieser Methode für ChronoUnit implementiert. Die Einheiten NANOS, MICROS, MILLIS, SECONDS, MINUTES, HOURS, HALF_DAYS und DAYS werden unterstützt. Andere ChronoUnit-Werte lösen eine Ausnahme aus. Wenn es sich bei der Einheit nicht um eine ChronoUnit handelt, wird das Ergebnis dieser Methode durch Aufrufen von TemporalUnit.between(Temporal, Temporal) abgerufen, das als erstes Argument und die konvertierte Eingabe als zweites Argument übergeben wird. Diese Instanz ist unveränderlich und von diesem Methodenaufruf nicht betroffen.

Throws: ArithmeeticException if numeric overflow occurs

Throws: DateTimeException if the amount cannot be calculated, or the end temporal cannot be converted to an Instant

Throws: UnsupportedTemporalTypeException if the unit is not supported

Android-Referenz für java.time.Instant.until.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: