Lenguaje

Instant.Until(ITemporal, ITemporalUnit) Método

Definición

Calcula la cantidad de tiempo hasta otro instante en términos de la unidad 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: la fecha de finalización, exclusiva, que se convierte en instantánea, no null.

unit
ITemporalUnit

TemporalUnit: unidad en la que se va a medir la cantidad, no null

Devoluciones

la cantidad de tiempo entre este instante y el instante final

Implementaciones

Atributos

Comentarios

Calcula la cantidad de tiempo hasta otro instante en términos de la unidad especificada. Esto calcula la cantidad de tiempo entre dos objetos Instant en términos de un único TemporalUnit. Los puntos inicial y final son esto y el instante especificado. El resultado será negativo si el final es antes del inicio. El cálculo devuelve un número entero, que representa el número de unidades completas entre los dos instantes. El valor temporal pasado a este método se convierte en un elemento Instant mediante from(TemporalAccessor). Por ejemplo, la cantidad en segundos entre dos fechas se puede calcular mediante startInstant.until(endInstant, SECONDS). Hay dos formas equivalentes de usar este método. La primera consiste en invocar este método. El segundo consiste en usar TemporalUnit.between(Temporal,Temporal): se debe elegir en función de lo cual el código sea más legible. El cálculo se implementa en este método para ChronoUnit. Se admiten las unidades NANOS, MICROS, MILLIS, SECONDS, MINUTES, HOURS, HALF_DAYS y DAYS. Otros valores ChronoUnit producirán una excepción. Si la unidad no es un ChronoUnit, el resultado de este método se obtiene invocando TemporalUnit.between(Temporal, Temporal) pasando esto como primer argumento y la entrada convertida temporal como segundo argumento. Esta instancia es inmutable y no se ve afectada por esta llamada de método.

Produce: ArithmeticException si se produce un desbordamiento numérico

Inicia: DateTimeException si no se puede calcular la cantidad, o bien no se puede convertir el valor temporal final en un instante.

Throws: UnsupportedTemporalesTypeException si no se admite la unidad

Referencia de Android para java.time.Instant.until.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a