Idioma

Duration.Add(Duration) Método

Definição

Calcula uma nova duração cujo valor é 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 adicionar a isso Duration

Retornos

Objeto Duration não nulo válido.

Atributos

Exceções

Se o parâmetro rhs for nulo.

Se duas durações não puderem ser adicionadas significativamente. Por exemplo, adicionar negativo um dia a um mês causa essa exceção.

Comentários

Calcula uma nova duração cujo valor é this+rhs.

Por exemplo

"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

Como não há como subtrair significativamente um dia a partir de 1 mês, há casos em que a operação falha.IllegalStateException

Formalmente, a computação é definida da seguinte maneira.

Em primeiro lugar, podemos supor que dois Durations a serem adicionados são positivos sem perder a generalidade (ou seja, (-X)+Y=Y-X, , X+(-Y)=X-Y) (-X)+(-Y)=-(X+Y)

A adição de dois positivos Durationé simplesmente definida como campo por adição de campo em que os campos ausentes são tratados como 0.

Um campo do resultado Duration será não definido se e somente se os respectivos campos de duas entradas Durationnão estiverem definidos.

Observe que lhs.add(rhs) será sempre bem-sucedido se lhs.signum()*rhs.signum()!=-1 ou ambos forem normalizados.

Java documentação para javax.xml.datatype.Duration.add(javax.xml.datatype.Duration).

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

Aplica-se a

Confira também