ZonedDateTime.Until(ITemporal, ITemporalUnit) Méthode

[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

Retours

durée entre cette date et l’heure de fin

Implémente

Attributs

RegisterAttribute

Remarques

Calcule la durée jusqu’à une autre date-heure en termes d’unité spécifiée. Cela calcule la durée entre deux objets ZonedDateTime en termes d’unité temporelle unique. Les points de début et de fin sont les suivants et l’heure de date spécifiée. Le résultat est négatif si la fin est avant le début. Par exemple, le montant en jours entre deux dates peut être calculé à l’aide de startDateTime.until(endDateTime, DAYS). Le temporal passé à cette méthode est converti en ZonedDateTime à l’aide de(TemporalAccessor). Si le fuseau horaire diffère entre les deux heures de date interzone, la date de fin spécifiée est normalisée pour avoir le même fuseau que cette date-heure. Le calcul retourne un nombre entier, représentant le nombre d’unités complètes entre les deux dates-heures. Par exemple, le montant des mois compris entre 2012-06-15T00:00Z et 2012-08-14T23:59Z ne sera qu’un mois, car il ne sera qu’une minute à court de deux mois. 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 NANOS, MICROS, MILLIS, SECONDES, MINUTES, HEURES et HALF_DAYS, JOURS, SEMAINES, MOIS, ANNÉES, DÉCENNIES, SIÈCLES, MILLENNIA et ERAS sont pris en charge. D’autres valeurs ChronoUnit lèvent une exception. Le calcul des unités de date et d’heure diffère. Les unités de date fonctionnent sur la ligne de temps locale, à l’aide de la date-heure locale. Par exemple, la période comprise entre midi le jour 1 et midi le jour suivant dans les jours sera toujours comptabilisée comme exactement un jour, qu’il y ait un changement d’épargne d’été ou non. Les unités de temps fonctionnent sur la ligne de temps instantanée. Le calcul convertit efficacement les deux dates interzones en instants, puis calcule la période entre les instants. Par exemple, la période comprise entre midi et midi le jour suivant en heures peut être de 23, 24 ou 25 heures (ou un autre montant) selon qu’il y avait un changement d’épargne d’été ou non. 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.ZonedDateTime.until.