Lingua

Duration.Add(Duration) Metodo

Definizione

Calcola una nuova durata il cui valore è 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

Parametri

rhs
Duration

Duration per aggiungere a questo Duration

Valori restituiti

oggetto Duration non null valido.

Attributi

Eccezioni

Se il parametro rhs è Null.

Se due durate non possono essere aggiunte in modo significativo. Ad esempio, l'aggiunta di un giorno negativo a un mese causa questa eccezione.

Commenti

Calcola una nuova durata il cui valore è this+rhs.

Ad esempio:

"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

Poiché non è possibile sottrarre significativamente 1 giorno da 1 mese, esistono casi in cui l'operazione ha esito negativo in IllegalStateException.

Formalmente, il calcolo è definito come segue.

In primo luogo, possiamo presupporre che due Durations da aggiungere siano entrambi positivi senza perdere la generalità (ad esempio, (-X)+Y=Y-X, X+(-Y)=X-Y, (-X)+(-Y)=-(X+Y))

L'aggiunta di due valori positivi Durationè semplicemente definita come campo dall'aggiunta di campi in cui i campi mancanti vengono considerati come 0.

Un campo dell'oggetto risultante verrà annullato Duration se e solo se i rispettivi campi di due input Durationsono unset.

Si noti che lhs.add(rhs) avrà sempre esito positivo se lhs.signum()*rhs.signum()!=-1 o entrambi vengono normalizzati.

per javax.xml.datatype.Duration.add(javax.xml.datatype.Duration).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a

Vedi anche