Year.Until(ITemporal, ITemporalUnit) 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.
Calcule la durée jusqu’à une autre année 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
date de fin, exclusive, convertie en année, et non null
- unit
- ITemporalUnit
unité pour mesurer la quantité en, et non null
Retours
durée entre cette année et l’année de fin
Implémente
- Attributs
Remarques
Calcule la durée jusqu’à une autre année en termes d’unité spécifiée. Cela calcule la durée entre deux objets Year en termes d’une unité temporelle unique. Les points de début et de fin sont les suivants et l’année spécifiée. Le résultat est négatif si la fin est avant le début. Le temporal passé à cette méthode est converti en année à l’aide de(TemporalAccessor). Par exemple, le montant en décennies entre deux ans peut être calculé à l’aide de startYear.until(endYear, DECADES). Le calcul retourne un nombre entier, représentant le nombre d’unités complètes entre les deux années. Par exemple, le montant des décennies entre 2012 et 2031 ne sera qu’une décennie, car il s’agit d’un an à court de deux décennies. Il existe deux méthodes équivalentes d’utilisation de cette méthode. La première consiste à appeler cette méthode. La deuxième 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 YEARS, DECADES, CENTURIES, MILLENNIA et ERAS 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.
Java référence pour java.time.Year.until.