OffsetTime.Until(ITemporal, ITemporalUnit) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Calcula a quantidade de tempo até outra hora em termos da unidade especificada.
[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
Parâmetros
- endExclusive
- ITemporal
a hora de término, exclusiva, que é convertida em um OffsetTime, não nulo
- unit
- ITemporalUnit
a unidade na qual medir o valor, não nulo
Retornos
a quantidade de tempo entre essa hora e a hora de término
Implementações
- Atributos
Comentários
Calcula a quantidade de tempo até outra hora em termos da unidade especificada. Isso calcula a quantidade de tempo entre dois objetos OffsetTime em termos de um único TemporalUnit. Os pontos de início e de término são esta e a hora especificada. O resultado será negativo se o final for antes do início. Por exemplo, o valor em horas entre duas vezes pode ser calculado usando startTime.until(endTime, HOURS). O temporal passado para esse método é convertido em um OffsetTime usando de(TemporalAccessor). Se o deslocamento for diferente entre as duas vezes, a hora de término especificada será normalizada para ter o mesmo deslocamento desta vez. O cálculo retorna um número inteiro, representando o número de unidades completas entre as duas vezes. Por exemplo, a quantidade em horas entre 11:30Z e 13:29Z será de apenas uma hora, pois é um minuto a menos de duas horas. Há duas maneiras equivalentes de usar esse método. A primeira é invocar esse método. A segunda é usar TemporalUnit.between(Temporal, Temporal): a escolha deve ser feita com base no qual torna o código mais legível. O cálculo é implementado neste método para ChronoUnit. Há suporte para as unidades NANOS, MICROS, MILLIS, SECONDS, MINUTES, HOURS e HALF_DAYS. Outros valores chronoUnit gerarão uma exceção. Se a unidade não for um ChronoUnit, o resultado desse método será obtido invocando TemporalUnit.between(Temporal, Temporal) passando isso como o primeiro argumento e o temporal de entrada convertido como o segundo argumento. Essa instância é imutável e não afetada por essa chamada de método.
Java referência para java.time.OffsetTime.until.