Sprache

YearMonth.Until(ITemporal, ITemporalUnit) Methode

Definition

Berechnet die Zeitspanne bis zu einem anderen Jahrmonat 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

enddatum, exklusiv, das in ein YearMonth umgewandelt wird, nicht null

unit
ITemporalUnit

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

Gibt zurück

Zeitraum zwischen diesem Jahresmonat und dem Endjahrmonat

Implementiert

Attribute

Hinweise

Berechnet die Zeitspanne bis zu einem anderen Jahrmonat in Bezug auf die angegebene Einheit. Dadurch wird die Zeitspanne zwischen zwei YearMonth -Objekten in Bezug auf eine einzelne TemporalUnit berechnet. Die Anfangs- und Endpunkte sind dies und der angegebene Jahresmonat. Das Ergebnis wird negativ sein, wenn das Ende vor dem Start liegt. Der an diese Methode übergebene Temporal wird mithilfe von (TemporalAccessor) in ein YearMonth-Format konvertiert. Der Betrag in Jahren zwischen zwei Jahresmonaten kann z. B. mit startYearMonth.until(endYearMonth, YEARS) berechnet werden. Die Berechnung gibt eine ganze Zahl zurück, die die Anzahl der vollständigen Einheiten zwischen den zwei Jahresmonaten darstellt. Beispielsweise wird der Betrag in Jahrzehnten zwischen 2012-06 und 2032-05 nur ein Jahrzehnt betragen, da er einen Monat kurz vor zwei Jahrzehnten 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 MONATE, JAHRE, JAHRZEHNTE, JAHRHUNDERTE, MILLENNIA und ERAS 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.YearMonth.until.

Gilt für: