Langue

ChronoUnit.Between(ITemporal, ITemporal) Méthode

Définition

Calcule la durée entre deux objets temporels.

[Android.Runtime.Register("between", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/Temporal;)J", "", ApiSince=26)]
public long Between(Java.Time.Temporal.ITemporal? temporal1Inclusive, Java.Time.Temporal.ITemporal? temporal2Exclusive);
[<Android.Runtime.Register("between", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/Temporal;)J", "", ApiSince=26)>]
abstract member Between : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporal -> int64
override this.Between : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporal -> int64

Paramètres

temporal1Inclusive
ITemporal

l’objet temporel de base, et non null

temporal2Exclusive
ITemporal

l’autre objet temporel, exclusif, non null

Retours

durée entre temporal1Inclusive et temporal2Exclusive en termes de cette unité ; positif si temporal2Exclusive est plus tard que temporal1Inclusive, négatif si précédemment

Implémente

Attributs

Remarques

Calcule la durée entre deux objets temporels. Cela calcule le montant en termes de cette unité. Les points de début et de fin sont fournis en tant qu’objets temporels et doivent être de types compatibles. L’implémentation convertit le deuxième type en instance du premier type avant le calcul de la quantité. Le résultat est négatif si la fin est avant le début. Par exemple, la quantité en heures entre deux objets temporels peut être calculée à l’aide d’HOURS.between(startTime, endTime). Le calcul retourne un nombre entier, représentant le nombre d’unités complètes entre les deux durées. Par exemple, la quantité en heures comprises entre les heures 11:30 et 13:29 ne sera qu’une heure, car il s’agit d’une minute de moins de deux heures. Il existe deux méthodes équivalentes d’utilisation de cette méthode. La première consiste à appeler cette méthode directement. La deuxième consiste à utiliser Temporal.until(Temporal, TemporalUnit) :

// these two lines are equivalent
between = thisUnit.between(start, end);
between = start.until(end, thisUnit);

Le choix doit être fait en fonction de ce qui rend le code plus lisible. Par exemple, cette méthode permet de calculer le nombre de jours entre deux dates :

long daysBetween = DAYS.between(start, end);
// or alternatively
long daysBetween = start.until(end, DAYS);

Les implémentations doivent effectuer des requêtes ou des calculs à l’aide des unités disponibles dans ChronoUnit ou des champs disponibles dans ChronoField. Si l’unité n’est pas prise en charge, une exception UnsupportedTemporalTypeException doit être levée. Les implémentations ne doivent pas modifier les objets temporels spécifiés.

Java référence pour java.time.temporal.ChronoUnit.between.

S’applique à