Year.Until(ITemporal, ITemporalUnit) Methode

Definition

Namespace:: Java.Time

Assembly:: Mono.Android.dll

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 Jahr 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 Jahr umgewandelt wird, nicht NULL

unit: ITemporalUnit

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

Gibt zurück

Int64

die Zeitspanne zwischen diesem Jahr und dem Endjahr

Implementiert

Until(ITemporal, ITemporalUnit)

Attribute: RegisterAttribute

Hinweise

Berechnet die Zeitspanne bis zu einem anderen Jahr in Bezug auf die angegebene Einheit. Dadurch wird die Zeitspanne zwischen zwei Year-Objekten in Bezug auf eine einzelne TemporalUnit berechnet. Die Anfangs- und Endpunkte sind dies und das angegebene Jahr. Das Ergebnis wird negativ sein, wenn das Ende vor dem Start liegt. Der an diese Methode übergebene Temporal wird mithilfe von (TemporalAccessor) in ein Jahr konvertiert. Beispielsweise kann der Betrag in Jahrzehnten zwischen zwei Jahren mit startYear.until(endYear, DECADES) berechnet werden. Die Berechnung gibt eine ganze Zahl zurück, die die Anzahl der vollständigen Einheiten zwischen den beiden Jahren darstellt. Beispielsweise wird der Betrag in Jahrzehnten zwischen 2012 und 2031 nur ein Jahrzehnt betragen, da es ein Jahr 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 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.Year.until.

Gilt für: