ZonedDateTime.Until(ITemporal, ITemporalUnit) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Calcula la cantidad de tiempo hasta otra fecha y hora 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 -> int64Parámetros
- endExclusive
- ITemporal
la fecha de finalización, exclusiva, que se convierte en ZonedDateTime, no null.
- unit
- ITemporalUnit
la unidad en la que se va a medir la cantidad, no null
Devoluciones
la cantidad de tiempo entre esta fecha y hora de finalización
Implementaciones
- Atributos
Comentarios
Calcula la cantidad de tiempo hasta otra fecha y hora en términos de la unidad especificada. Esto calcula la cantidad de tiempo entre dos objetos ZonedDateTime en términos de un único TemporalUnit. Los puntos de inicio y finalización son estos y la fecha y hora especificadas. El resultado será negativo si el final es antes del inicio. Por ejemplo, la cantidad en días entre dos fechas y horas se puede calcular mediante startDateTime.until(endDateTime, DAYS). El valor temporal pasado a este método se convierte en ZonedDateTime mediante from(TemporalAccessor). Si la zona horaria difiere entre las dos fechas y horas con zona, la fecha y hora de finalización especificada se normaliza para tener la misma zona que esta fecha y hora. El cálculo devuelve un número entero, que representa el número de unidades completas entre las dos fechas y horas. Por ejemplo, la cantidad en meses entre 2012-06-15T00:00Z y 2012-08-14T23:59Z solo será un mes, ya que es un minuto corto de dos meses. Hay dos formas equivalentes de usar este método. La primera consiste en invocar este método. La segunda consiste en usar TemporalUnit.between(Temporal, Temporal): se debe elegir en función de la 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 y HALF_DAYS, DAYS, WEEKS, MONTHS, YEARS, DECADES, CENTURIES, MILLENNIA y ERAS. Otros valores ChronoUnit producirán una excepción. El cálculo de las unidades de fecha y hora difiere. Las unidades de fecha funcionan en la línea horaria local, con la fecha y hora local. Por ejemplo, el período del mediodía del día 1 al mediodía del día siguiente en días siempre se contará como exactamente un día, independientemente de si se ha cambiado o no el horario de verano. Las unidades de tiempo funcionan en la línea de tiempo instantánea. El cálculo convierte eficazmente las fechas y horas de zona en instantes y, a continuación, calcula el período entre los instantes. Por ejemplo, el período del mediodía del día 1 al mediodía del día siguiente en horas puede ser de 23, 24 o 25 horas (o alguna otra cantidad) dependiendo de si se ha cambiado o no un horario de verano. 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.
referencia Java referencia para java.time.ZonedDateTime.until.