Duration.Add(Duration) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.