Langage

Instant.Until(ITemporal, ITemporalUnit) Méthode

Définition

Calcule la durée jusqu’à un autre instant en termes d’unité spécifiée.

[Android.Runtime.Register("until", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/TemporalUnit;)J", "", ApiSince=26)]
public long Until(Java.Time.Temporal.ITemporal? endExclusive, Java.Time.Temporal.ITemporalUnit? unit);
[<Android.Runtime.Register("until", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/TemporalUnit;)J", "", ApiSince=26)>]
abstract member Until : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporalUnit -> int64
override this.Until : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporalUnit -> int64

Paramètres

endExclusive
ITemporal

Temporelle : date de fin, exclusive, qui est convertie en un instant, et non null

unit
ITemporalUnit

TemporalUnit : unité pour mesurer la quantité en, et non null

Retours

durée entre cet instant et l’instant de fin

Implémente

Attributs

Remarques

Calcule la durée jusqu’à un autre instant en termes d’unité spécifiée. Cela calcule la durée entre deux objets Instantanés en termes d’une unité temporelle unique. Les points de début et de fin sont ceci et l’instant spécifié. Le résultat est négatif si la fin est avant le début. Le calcul retourne un nombre entier, représentant le nombre d’unités complètes entre les deux instants. Le temporal passé à cette méthode est converti en un instant à partir de(TemporalAccessor). Par exemple, la quantité en secondes entre deux dates peut être calculée à l’aide de startInstant.until(endInstant, SECONDS). Il existe deux méthodes équivalentes d’utilisation de cette méthode. La première consiste à appeler cette méthode. La seconde consiste à utiliser TemporalUnit.between(Temporal,Temporal) : le choix doit être fait en fonction de ce qui rend le code plus lisible. Le calcul est implémenté dans cette méthode pour ChronoUnit. Les unités NANOS, MICROS, MILLIS, SECONDS, MINUTES, HEURES, HALF_DAYS et DAYS sont prises en charge. D’autres valeurs ChronoUnit lèvent une exception. Si l’unité n’est pas un ChronoUnit, le résultat de cette méthode est obtenu en appelant TemporalUnit.between(Temporal, Temporal) en passant cela en tant que premier argument et le temps d’entrée converti comme deuxième argument. Cette instance est immuable et non affectée par cet appel de méthode.

Levées : arithmétiqueException si le dépassement numérique se produit

Levées : DateTimeException si la quantité ne peut pas être calculée ou si la durée de fin ne peut pas être convertie en un instant

Levées : UnsupportedTemporalTypeException si l’unité n’est pas prise en charge

Référence Android pour java.time.Instant.until.

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 à