ZonedDateTime.Until(ITemporal, ITemporalUnit) Método

[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

Retornos

a quantidade de tempo entre essa data e a data e a hora de término

Implementações

Atributos

RegisterAttribute

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 ZonedDateTime 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. Por exemplo, o valor em dias entre duas datas pode ser calculado usando startDateTime.until(endDateTime, DAYS). O temporal passado para esse método é convertido em um ZonedDateTime usando(TemporalAccessor). Se o fuso horário for diferente entre os dois horários de data e hora zoneados, a data e hora de término especificada será normalizada para ter a mesma zona que essa data e hora. 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:00Z e 2012-08-14T23:59Z será apenas um mês, pois falta um minuto para 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. O cálculo das unidades de data e hora é diferente. As unidades de data operam na linha de hora local, usando a data e hora local. Por exemplo, o período do meio-dia do dia 1 ao meio-dia do dia seguinte em dias sempre será contado como exatamente um dia, independentemente de haver uma alteração de horário de verão ou não. As unidades de tempo operam na linha de tempo instantânea. O cálculo converte efetivamente data-hora zoneada em instantes e, em seguida, calcula o período entre os instantes. Por exemplo, o período do meio-dia do dia 1 ao meio-dia do dia seguinte em horas pode ser de 23, 24 ou 25 horas (ou algum outro valor), dependendo se houve uma alteração de horário de verão ou nã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.ZonedDateTime.until.