op:subtract-dayTimeDurations

Subtracts the value of $dayTimeDuration-var2 from $dayTimeDuration-var1.

Signatures

op:subtract-dayTimeDurations(xf:dayTimeDuration $dayTimeDuration-var1, xf:dayTimeDuration $dayTimeDuration-var2) —> xf:dayTimeDuration

Arguments

Data Type
Argument
Description

xf:dayTimeDuration

$dayTimeDuration-var1

Contains a time duration that can contain days, hours, minutes, and seconds.

xf:dayTimeDuration

$dayTimeDuration-var2

Contains a time duration that can contain days, hours, minutes, and seconds.

Returns

Returns the dayTimeDuration value of subtracting $dayTimeDuration-var2 from $dayTimeDuration-var1.

Examples

Positive

The following example query subtracts a dayTimeDuration value equal to 1 day and 1 minute from a dayTimeDuration value equal to 3 days, 3 hours, 3 minutes, and 3 seconds as shown in the following query:

<positive>{
		op:subtract-dayTimeDurations(xf:dayTimeDuration("P3DT3H3M3S"), xf:dayTimeDuration("P1DT1M"))
}</positive> 

The resulting positive dayTimeDuration value of 2 days, 3 hours, 2 minutes and 3 seconds is returned as shown in the following result:

<positive>P2DT3H2M3S</positive> 

Negative

The following example query subtracts a dayTimeDuration value equal to 3 days, 3 hours, 3 minutes, and 3 seconds from a dayTimeDuration value equal to 1 day and 1 minute as shown in the following query:

<negative>{
		op:subtract-dayTimeDurations(xf:dayTimeDuration("P1DT1M"), xf:dayTimeDuration("P3DT3H3M3S"))
}</negative> 

The resulting negative dayTimeDuration value of 2 years and 2 months is returned as shown in the following result:

<negative>-P2DT3H2M3S</negative> 

Related Topics

W3C subtract-dayTimeDurations operator description.

W3C dayTimeDuration description.

xf:dayTimeDuration constructor description.