Duration.AddTo Méthode

Définition

Espace de noms:

Javax.Xml.Datatype

Assembly:

Mono.Android.dll

Surcharges

AddTo(Calendar)	Ajoute cette durée à un Calendar objet.
AddTo(Date)	Ajoute cette durée à un Date objet.

AddTo(Calendar)

Ajoute cette durée à un Calendar objet.

[Android.Runtime.Register("addTo", "(Ljava/util/Calendar;)V", "GetAddTo_Ljava_util_Calendar_Handler")]
public abstract void AddTo (Java.Util.Calendar? calendar);

[<Android.Runtime.Register("addTo", "(Ljava/util/Calendar;)V", "GetAddTo_Ljava_util_Calendar_Handler")>]
abstract member AddTo : Java.Util.Calendar -> unit

Paramètres

calendar

Calendar

Objet calendrier dont la valeur sera modifiée.

Attributs

RegisterAttribute

Exceptions

NullPointerException

si le paramètre de calendrier a la valeur Null.

Remarques

Ajoute cette durée à un Calendar objet.

Appelle java.util.Calendar#add(int,int) l’ordre des années, mois, jours, heures, minutes, secondes et millisecondes si ces champs sont présents. Étant donné que la Calendar classe utilise int pour contenir des valeurs, il existe des cas où cette méthode ne fonctionnera pas correctement (par exemple si les valeurs de champs dépassent la plage d’int.)

En outre, étant donné que cette classe de durée est une durée grégorienne, cette méthode ne fonctionnera pas correctement si l’objet donné Calendar est basé sur d’autres systèmes de calendrier.

Toutes les parties fractionnaires de cet Duration objet au-delà des millisecondes sont simplement ignorées. Par exemple, si cette durée est « P1.23456S », 1 est ajouté à SECONDS, 234 est ajouté à MILLISECONDS et le reste n’est pas utilisé.

Notez que, étant donné que l’utilisation Calendar#add(int, int) est effectuée int, Duration avec des valeurs au-delà de la plage de int ses champs, entraîne le dépassement de capacité/sous-flux donné Calendar. XMLGregorianCalendar#add(Duration) fournit la même opération de base que cette méthode tout en évitant les problèmes de dépassement de capacité/sous-flux.

Documentation Java pour javax.xml.datatype.Duration.addTo(java.util.Calendar).

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

AddTo(Date)

Ajoute cette durée à un Date objet.

[Android.Runtime.Register("addTo", "(Ljava/util/Date;)V", "GetAddTo_Ljava_util_Date_Handler")]
public virtual void AddTo (Java.Util.Date? date);

[<Android.Runtime.Register("addTo", "(Ljava/util/Date;)V", "GetAddTo_Ljava_util_Date_Handler")>]
abstract member AddTo : Java.Util.Date -> unit
override this.AddTo : Java.Util.Date -> unit

Paramètres

date

Date

Objet date dont la valeur sera modifiée.

Attributs

RegisterAttribute

Exceptions

NullPointerException

si le paramètre de date a la valeur Null.

Remarques

Ajoute cette durée à un Date objet.

La date donnée est d’abord convertie en un java.util.GregorianCalendar, puis la durée est ajoutée exactement comme la #addTo(Calendar) méthode.

L’instant de temps mis à jour est ensuite converti en objet Date et utilisé pour mettre à jour l’objet donné Date .

Ce calcul quelque peu redondant est nécessaire pour déterminer sans ambiguïté la durée des mois et des années.

Documentation Java pour javax.xml.datatype.Duration.addTo(java.util.Date).

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