Langue

Calendar.FieldDifference(Date, CalendarField) Méthode

Définition

<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 &amp;&amp; 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.

S’applique à