ITemporalField.AdjustInto(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 mit dem Wert dieses Feldsatzes zurück.

[Android.Runtime.Register("adjustInto", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAdjustInto_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalFieldInvoker, 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? AdjustInto(Java.Lang.Object? temporal, long newValue);

[<Android.Runtime.Register("adjustInto", "(Ljava/time/temporal/Temporal;J)Ljava/time/temporal/Temporal;", "GetAdjustInto_Ljava_time_temporal_Temporal_JHandler:Java.Time.Temporal.ITemporalFieldInvoker, 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 AdjustInto : Java.Lang.Object * int64 -> Java.Lang.Object

Parameter

temporal: Object

das zeitliche Objekt, das angepasst werden soll, nicht NULL

newValue: Int64

der neue Wert des Felds

Gibt zurück

Object

das angepasste zeitliche Objekt, nicht NULL

Attribute: RegisterAttribute JavaTypeParametersAttribute

Hinweise

Gibt eine Kopie des angegebenen zeitlichen Objekts mit dem Wert dieses Feldsatzes zurück.

Dadurch wird ein neues zeitliches Objekt zurückgegeben, das auf dem angegebenen Objekt basiert, wobei der Wert für dieses Feld geändert wurde. In einem LocalDateBeispiel kann dies verwendet werden, um das Jahr, den Monat oder den Tag des Monats festzulegen. Das zurückgegebene Objekt weist denselben observablen Typ wie das angegebene Objekt auf.

In einigen Fällen ist das Ändern eines Felds nicht vollständig definiert. Wenn das Zielobjekt beispielsweise ein Datum ist, das den 31. Januar darstellt, wäre eine Änderung des Monats in Februar unklar. In solchen Fällen ist die Implementierung für die Auflösung des Ergebnisses verantwortlich. In der Regel wird das vorherige gültige Datum ausgewählt, bei dem es sich um den letzten gültigen Tag im Februar in diesem Beispiel handelt.

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#with(TemporalField, long):

// these two lines are equivalent, but the second approach is recommended
              temporal = thisField.adjustInto(temporal);
              temporal = temporal.with(thisField);

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

Implementierungen sollten Abfragen oder Berechnungen mit den in ChronoFieldder Datei verfügbaren Feldern ausführen. Wenn das Feld nicht unterstützt wird, muss ein UnsupportedTemporalTypeException Fehler 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.TemporalField.adjustInto(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: