Duration.Add(Duration) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.