Year.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é mais um ano 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 data de término, exclusiva, que é convertida em um Ano, não nula
- unit
- ITemporalUnit
a unidade na qual medir o valor, não nulo
Retornos
a quantidade de tempo entre este ano e o final do ano
Implementações
- Atributos
Comentários
Calcula a quantidade de tempo até mais um ano em termos da unidade especificada. Isso calcula a quantidade de tempo entre dois objetos Year em termos de um único TemporalUnit. Os pontos de início e de término são este e o ano especificado. O resultado será negativo se o final for antes do início. O temporal passado para esse método é convertido em um Ano usando(TemporalAccessor). Por exemplo, o valor em décadas entre dois anos pode ser calculado usando startYear.until(endYear, DECADES). O cálculo retorna um número inteiro, representando o número de unidades completas entre os dois anos. Por exemplo, o valor em décadas entre 2012 e 2031 será de apenas uma década, pois está a um ano de duas décadas. 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 YEARS, DECADES, CENTURYS, MILLENNIA e ERAS. 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.Year.until.