Lenguaje

Duration.Add(Duration) Método

Definición

Calcula una nueva duración cuyo valor es this+rhs.

[Android.Runtime.Register("add", "(Ljavax/xml/datatype/Duration;)Ljavax/xml/datatype/Duration;", "GetAdd_Ljavax_xml_datatype_Duration_Handler")]
public abstract Javax.Xml.Datatype.Duration? Add(Javax.Xml.Datatype.Duration? rhs);
[<Android.Runtime.Register("add", "(Ljavax/xml/datatype/Duration;)Ljavax/xml/datatype/Duration;", "GetAdd_Ljavax_xml_datatype_Duration_Handler")>]
abstract member Add : Javax.Xml.Datatype.Duration -> Javax.Xml.Datatype.Duration

Parámetros

rhs
Duration

Duration para agregarlo a este Duration

Devoluciones

objeto Duration no null válido.

Atributos

Excepciones

Si el parámetro rhs es null.

Si no se pueden agregar dos duraciones significativamente. Por ejemplo, agregar un día negativo a un mes provoca esta excepción.

Comentarios

Calcula una nueva duración cuyo valor es this+rhs.

Por ejemplo

"1 day" + "-3 days" = "-2 days"
            "1 year" + "1 day" = "1 year and 1 day"
            "-(1 hour,50 minutes)" + "-20 minutes" = "-(1 hours,70 minutes)"
            "15 hours" + "-3 days" = "-(2 days,9 hours)"
            "1 year" + "-1 day" = IllegalStateException

Puesto que no hay ninguna manera de restar significativamente 1 día de 1 mes, hay casos en los que se produce un error en la operación en IllegalStateException.

Formalmente, el cálculo se define de la manera siguiente.

En primer lugar, podemos suponer que dos Durations que se van a agregar son positivas sin perder la generalidad (es decir, (-X)+Y=Y-X, , X+(-Y)=X-Y) (-X)+(-Y)=-(X+Y)

La adición de dos positivos Durationse define simplemente como campo por adición de campo donde los campos que faltan se tratan como 0.

Un campo del resultado Duration se anulará si y solo si los campos respectivos de dos entradas Durationestán sin establecer.

Tenga en cuenta que lhs.add(rhs) siempre se realizará correctamente si lhs.signum()*rhs.signum()!=-1 o ambos están normalizados.

Java documentación para javax.xml.datatype.Duration.add(javax.xml.datatype.Duration).

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

Consulte también