ITemporalUnit.AddTo(Object, Int64) Methode

Definition

Namespace:: Java.Time.Temporal

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.

Gibt eine Kopie des angegebenen zeitlichen Objekts zurück, wobei der angegebene Punkt hinzugefügt wurde.

[Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)]
[Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })]
public Java.Lang.Object? AddTo(Java.Lang.Object? temporal, long amount);

[<Android.Runtime.Register("addTo", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAddTo_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "R extends java.time.temporal.Temporal" })>]
abstract member AddTo : Java.Lang.Object * int64 -> Java.Lang.Object

Parameter

temporal: Object

das zeitliche Objekt, das angepasst werden soll, nicht NULL

amount: Int64

die Menge dieser Einheit, die addieren, positiv oder negativ hinzugefügt werden soll

Gibt zurück

Object

das angepasste zeitliche Objekt, nicht NULL

Attribute: RegisterAttribute JavaTypeParametersAttribute

Hinweise

Gibt eine Kopie des angegebenen zeitlichen Objekts zurück, wobei der angegebene Punkt hinzugefügt wurde.

Der hinzugefügte Punkt ist ein Vielfaches dieser Einheit. Diese Methode kann z. B. verwendet werden, um "3 Tage" zu einem Datum hinzuzufügen, indem diese Methode für die Instanz aufgerufen wird, die "Tage" darstellt, das Datum und den Punkt "3" übergeben. Der hinzuzufügende Zeitraum kann negativ sein, was der Subtraktion entspricht.

Es gibt zwei äquivalente Methoden zur Verwendung dieser Methode. Die erste besteht darin, diese Methode direkt aufzurufen. Die zweite besteht darin, Folgendes zu verwenden Temporal#plus(long, TemporalUnit):

// these two lines are equivalent, but the second approach is recommended
              temporal = thisUnit.addTo(temporal);
              temporal = temporal.plus(thisUnit);

Es wird empfohlen, den zweiten Ansatz zu verwenden, plus(TemporalUnit)da es viel klarer ist, im Code zu lesen.

Implementierungen sollten Abfragen oder Berechnungen mithilfe der verfügbaren ChronoUnit Einheiten oder der verfügbaren Felder ausführen ChronoField. Wenn die Einheit nicht unterstützt wird, muss sie UnsupportedTemporalTypeException ausgelöst werden.

Implementierungen dürfen das angegebene zeitliche Objekt nicht ändern. Stattdessen muss eine angepasste Kopie des Originals zurückgegeben werden. Dies bietet ein gleichwertiges, sicheres Verhalten für unveränderliche und veränderliche Implementierungen.

Java Dokumentation für java.time.temporal.TemporalUnit.addTo(R, long).

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: