ITemporalUnit.Between(ITemporal, ITemporal) Método

Referência

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", "GetBetween_Ljava_time_temporal_Temporal_Ljava_time_temporal_Temporal_Handler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", 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", "GetBetween_Ljava_time_temporal_Temporal_Ljava_time_temporal_Temporal_Handler:Java.Time.Temporal.ITemporalUnitInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
abstract member 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 temporal2Exclusivo for posterior ao temporal1Inclusive, negativo se anterior

Atributos: RegisterAttribute

Comentários

Calcula a quantidade de tempo entre dois objetos temporais.

Isso calcula o valor em termos dessa unidade. Os pontos inicial e final são fornecidos como objetos temporais e devem ser de tipos compatíveis. A implementação converterá o segundo tipo em uma instância do primeiro tipo antes do cálculo do valor. O resultado será negativo se o final for antes da largada. 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 os horários 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 realizar quaisquer consultas ou cálculos usando as unidades disponíveis em ChronoUnit ou os campos disponíveis em ChronoField. Se a unidade não for suportada, um UnsupportedTemporalTypeException deve ser lançado. As implementações não devem alterar os objetos temporais especificados.

Documentação Java para java.time.temporal.TemporalUnit.between(java.time.temporal.Temporal, java.time.temporal.Temporal).

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

Aplica-se a

Compartilhar via