Sprache

OffsetTime.Until(ITemporal, ITemporalUnit) Methode

Definition

Berechnet die Zeitspanne bis zu einer anderen Zeit in Bezug auf die angegebene Einheit.

[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

end time, exclusive, which is converted to an OffsetTime, not null

unit
ITemporalUnit

die Einheit, in der der Betrag gemessen werden soll, nicht null

Gibt zurück

die Zeitspanne zwischen dieser Zeit und der Endzeit

Implementiert

Attribute

Hinweise

Berechnet die Zeitspanne bis zu einer anderen Zeit in Bezug auf die angegebene Einheit. Dadurch wird die Zeitspanne zwischen zwei OffsetTime-Objekten in Bezug auf eine einzelne TemporalUnit berechnet. Die Anfangs- und Endpunkte sind dies und die angegebene Uhrzeit. Das Ergebnis wird negativ sein, wenn das Ende vor dem Start liegt. Der Betrag in Stunden zwischen zwei Zeiten kann z. B. mit startTime.until(endTime, HOURS) berechnet werden. Der an diese Methode übergebene Temporal wird mithilfe von (TemporalAccessor) in einen OffsetTime-Objekt konvertiert. Wenn sich der Offset zwischen den beiden Zeiten unterscheidet, wird die angegebene Endzeit normalisiert, um den gleichen Offset wie diesmal zu haben. Die Berechnung gibt eine ganze Zahl zurück, die die Anzahl der vollständigen Einheiten zwischen den beiden Zeiten darstellt. Der Betrag in Stunden zwischen 11:30Z und 13:29Z beträgt beispielsweise nur eine Stunde, da es eine Minute kurz vor zwei Stunden ist. 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 und HALF_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.

Java Referenz für java.time.OffsetTime.until.

Gilt für: