ITemporalUnit.AddTo(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 période spécifiée ajoutée.

[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

Paramètres

temporal: Object

l’objet temporel à ajuster, et non null

amount: Int64

la quantité de cette unité à ajouter, positive ou négative

Retours

Object

l’objet temporel ajusté, et non null

Attributs: RegisterAttribute JavaTypeParametersAttribute

Remarques

Retourne une copie de l’objet temporel spécifié avec la période spécifiée ajoutée.

La période ajoutée est un multiple de cette unité. Par exemple, cette méthode peut être utilisée pour ajouter « 3 jours » à une date en appelant cette méthode sur l’instance représentant « jours », en passant la date et la période « 3 ». La période à ajouter peut être négative, ce qui équivaut à la soustraction.

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#plus(long, TemporalUnit):

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

Il est recommandé d’utiliser la deuxième approche, plus(TemporalUnit)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 unités disponibles ou ChronoUnit des champs disponibles dans ChronoField. Si l’unité n’est pas prise en charge, une UnsupportedTemporalTypeException exception 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.

Documentation Java pour java.time.temporal.TemporalUnit.addTo(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 à