YearMonth.Until(ITemporal, ITemporalUnit) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.