ITemporalUnit.Between(ITemporal, ITemporal) Méthode

Référence

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.

Calcule la durée entre deux objets temporels.

[Android.Runtime.Register("between", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/Temporal;)J", "GetBetween_Ljava_time_temporal_Temporal_Ljava_time_temporal_Temporal_Handler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", 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", "GetBetween_Ljava_time_temporal_Temporal_Ljava_time_temporal_Temporal_Handler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
abstract member 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

Int64

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

Attributs: RegisterAttribute

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 HOURS.between(startTime, endTime)de .

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 elle est d’une minute à court 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 seconde 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 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 les objets temporels spécifiés.

Documentation Java pour java.time.temporal.TemporalUnit.between(java.time.temporal.Temporal, java.time.temporal.Temporal).

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.

S’applique à

Partager via