ITemporalField.AdjustInto(Object, Int64) Méthode

Définition

Espace de noms:: Java.Time.Temporal

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne une copie de l’objet temporel spécifié avec la valeur de ce jeu de champs.

[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

Paramètres

temporal: Object

l’objet temporel à ajuster, et non null

newValue: Int64

nouvelle valeur du champ

Retours

Object

l’objet temporel ajusté, et non null

Attributs: RegisterAttribute JavaTypeParametersAttribute

Remarques

Retourne une copie de l’objet temporel spécifié avec la valeur de ce jeu de champs.

Cette opération retourne un nouvel objet temporel basé sur l’objet spécifié avec la valeur de ce champ modifié. Par exemple, sur un LocalDate, cela peut être utilisé pour définir l’année, le mois ou le jour du mois. L’objet retourné a le même type observable que l’objet spécifié.

Dans certains cas, la modification d’un champ n’est pas entièrement définie. Par exemple, si l’objet cible est une date représentant le 31 janvier, la modification du mois à février n’est pas claire. Dans ce cas, l’implémentation est responsable de la résolution du résultat. En règle générale, il choisira la date valide précédente, qui serait le dernier jour valide de février dans cet exemple.

Il existe deux méthodes équivalentes d’utilisation de cette méthode. La première consiste à appeler cette méthode directement. La seconde consiste à utiliser Temporal#with(TemporalField, long):

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

Il est recommandé d’utiliser la deuxième approche, with(TemporalField)car il est beaucoup plus clair de lire dans le code.

Les implémentations doivent effectuer des requêtes ou des calculs à l’aide des champs disponibles dans ChronoField. Si le champ n’est pas pris en charge, un UnsupportedTemporalTypeException doit être levée.

Les implémentations ne doivent pas modifier l’objet temporel spécifié. Au lieu de cela, une copie ajustée de l’original doit être retournée. Cela fournit un comportement équivalent et sécurisé pour les implémentations immuables et mutables.

Java documentation pour java.time.temporal.TemporalField.adjustInto(R, long).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à