Calendar.FieldDifference(Date, CalendarField) Méthode
Définition
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.
<strong>[icu]</strong> Renvoie la différence entre l’heure donnée et l’heure à laquelle cet objet calendrier est défini.
[Android.Runtime.Register("fieldDifference", "(Ljava/util/Date;I)I", "GetFieldDifference_Ljava_util_Date_IHandler", ApiSince=24)]
public virtual int FieldDifference(Java.Util.Date? when, Android.Icu.Util.CalendarField field);
[<Android.Runtime.Register("fieldDifference", "(Ljava/util/Date;I)I", "GetFieldDifference_Ljava_util_Date_IHandler", ApiSince=24)>]
abstract member FieldDifference : Java.Util.Date * Android.Icu.Util.CalendarField -> int
override this.FieldDifference : Java.Util.Date * Android.Icu.Util.CalendarField -> int
Paramètres
- when
- Date
date à laquelle comparer l’heure de ce calendrier à
- field
- CalendarField
champ dans lequel calculer le résultat
Retours
la différence, positive ou négative, entre l’heure de ce calendrier et when, en termes de field.
- Attributs
Remarques
<strong>[icu]</strong> Renvoie la différence entre l’heure donnée et l’heure à laquelle cet objet calendrier est défini. Si ce calendrier est défini <em>before</em> l’heure donnée, la valeur retournée est positive. Si ce calendrier est défini <em>after</em> l’heure donnée, la valeur retournée est négative. Le field paramètre spécifie les unités de la valeur de retour. Par exemple, si fieldDifference(when, Calendar.MONTH) elle retourne 3, ce calendrier est défini sur 3 mois avant when, et peut-être une durée supplémentaire inférieure à un mois.
En tant qu’effet secondaire de cet appel, ce calendrier est avancé vers when le montant donné. Autrement dit, l’appel de cette méthode a l’effet secondaire de l’appel add(field, n), où n est la valeur de retour.
Utilisation : Pour utiliser cette méthode, appelez-la d’abord avec le plus grand champ d’intérêt, puis avec des champs progressivement plus petits. Par exemple:
int y = cal.fieldDifference(when, Calendar.YEAR);
int m = cal.fieldDifference(when, Calendar.MONTH);
int d = cal.fieldDifference(when, Calendar.DATE);
calcule la différence entre cal et when en années, mois et jours.
Remarque : fieldDifference() est <em>asymétrique</em>. Autrement dit, dans le code suivant :
cal.setTime(date1);
int m1 = cal.fieldDifference(date2, Calendar.MONTH);
int d1 = cal.fieldDifference(date2, Calendar.DATE);
cal.setTime(date2);
int m2 = cal.fieldDifference(date1, Calendar.MONTH);
int d2 = cal.fieldDifference(date1, Calendar.DATE);
on pourrait s’attendre à ce que m1 == -m2 && d1 == -d2. Toutefois, ce n’est généralement pas le cas, en raison d’irrégularités dans le système de calendrier sous-jacent (par exemple, le calendrier grégorien a un nombre variable de jours par mois).
Java documentation pour android.icu.util.Calendar.fieldDifference(java.util.Date, int).
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.