Year.Until(ITemporal, ITemporalUnit) Método

Definição

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.

Aplica-se a