LocalDateTime.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 data e 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 data de término, exclusiva, que é convertida em LocalDateTime, não nula
- unit
- ITemporalUnit
a unidade na qual medir o valor, não nulo
Retornos
a quantidade de tempo entre essa data e a data e a hora de término
Implementações
- Atributos
Comentários
Calcula a quantidade de tempo até outra data e hora em termos da unidade especificada. Isso calcula a quantidade de tempo entre dois objetos LocalDateTime em termos de um único TemporalUnit. Os pontos de início e de término são esta e a data e hora especificadas. O resultado será negativo se o final for antes do início. O temporal passado para esse método é convertido em um LocalDateTime usando(TemporalAccessor). Por exemplo, o valor em dias entre duas datas pode ser calculado usando startDateTime.until(endDateTime, DAYS). O cálculo retorna um número inteiro, representando o número de unidades completas entre as duas datas. Por exemplo, o valor em meses entre 2012-06-15T00:00 e 2012-08-14T23:59 será apenas um mês, pois é um minuto a menos de dois meses. 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, DAYS, WEEKS, MONTHS, 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.LocalDateTime.until.