Instant.Until(ITemporal, ITemporalUnit) Método

Definição

Namespace:: Java.Time

Assembly:: Mono.Android.dll

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é outro instante 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

Temporal: a data de término, exclusiva, que é convertida em um Instantâneo, não nulo

unit: ITemporalUnit

TemporalUnit: a unidade na qual medir o valor, não nulo

Retornos

Int64

a quantidade de tempo entre esse instante e o instante final

Implementações

Until(ITemporal, ITemporalUnit)

Atributos: RegisterAttribute

Comentários

Calcula a quantidade de tempo até outro instante em termos da unidade especificada. Isso calcula a quantidade de tempo entre dois objetos instantâneos em termos de um único TemporalUnit. Os pontos de início e de término são este e o instante especificado. O resultado será negativo se o final for antes do início. O cálculo retorna um número inteiro, representando o número de unidades completas entre os dois instantes. O temporal passado para esse método é convertido em um Instant using from (TemporalAccessor). Por exemplo, a quantidade em segundos entre duas datas pode ser calculada usando startInstant.until(endInstant, SECONDS). 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 que 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, HALF_DAYS e 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.

Lançamentos: AritmeticException se ocorrer estouro numérico

Lançamentos: DateTimeException se o valor não puder ser calculado ou o tempo final não puder ser convertido em um Instantâneo

Lançamentos: UnsupportedTemporalTypeException se a unidade não tiver suporte

Referência do Android para java.time.Instant.until.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a