ChronoUnit.Between(ITemporal, ITemporal) Método

Definição

Namespace:: Java.Time.Temporal

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 entre dois objetos temporais.

[Android.Runtime.Register("between", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/Temporal;)J", "", ApiSince=26)]
public long Between(Java.Time.Temporal.ITemporal? temporal1Inclusive, Java.Time.Temporal.ITemporal? temporal2Exclusive);

[<Android.Runtime.Register("between", "(Ljava/time/temporal/Temporal;Ljava/time/temporal/Temporal;)J", "", ApiSince=26)>]
abstract member Between : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporal -> int64
override this.Between : Java.Time.Temporal.ITemporal * Java.Time.Temporal.ITemporal -> int64

Parâmetros

temporal1Inclusive: ITemporal

o objeto temporal base, não nulo

temporal2Exclusive: ITemporal

o outro objeto temporal, exclusivo, não nulo

Retornos

Int64

a quantidade de tempo entre temporal1Inclusive e temporal2Exclusive em termos desta unidade; positivo se temporal2Exclusive for posterior a temporal1Inclusive, negativo se anterior

Implementações

Between(ITemporal, ITemporal)

Atributos: RegisterAttribute

Comentários

Calcula a quantidade de tempo entre dois objetos temporais. Isso calcula a quantidade em termos desta unidade. Os pontos de início e de extremidade são fornecidos como objetos temporais e devem ser de tipos compatíveis. A implementação converterá o segundo tipo para ser uma instância do primeiro tipo antes de calcular o valor. O resultado será negativo se o final for antes do início. Por exemplo, a quantidade em horas entre dois objetos temporais pode ser calculada usando HOURS.between(startTime, endTime). O cálculo retorna um número inteiro, representando o número de unidades completas entre os dois temporais. Por exemplo, a quantidade em horas entre as vezes 11:30 e 13:29 será de apenas uma hora, pois é um minuto a menos de duas horas. Há duas maneiras equivalentes de usar esse método. A primeira é invocar esse método diretamente. A segunda é usar Temporal.until(Temporal, TemporalUnit):

// these two lines are equivalent
between = thisUnit.between(start, end);
between = start.until(end, thisUnit);

A escolha deve ser feita com base no que torna o código mais legível. Por exemplo, esse método permite que o número de dias entre duas datas seja calculado:

long daysBetween = DAYS.between(start, end);
// or alternatively
long daysBetween = start.until(end, DAYS);

As implementações devem executar consultas ou cálculos usando as unidades disponíveis no ChronoUnit ou os campos disponíveis em ChronoField. Se a unidade não tiver suporte, um UnsupportedTemporalTypeException deverá ser gerado. As implementações não devem alterar os objetos temporais especificados.

Java referência para java.time.temporal.ChronoUnit.between.

Aplica-se a