Duration.Add(Duration) 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 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.