Converts $string-var (a string in the dayTimeDuration format) to the dayTimeDuration data type.
If $string-var is the empty sequence, the empty sequence is returned. The empty sequence is a sequence containing zero items (), which is similar to null in SQL.
xf:dayTimeDuration(xs:string $string-var) —> xf:dayTimeDuration
Returns a duration of time as a dayTimeDuration value.
Invoking dayTimeDuration("P4DT9H8M20S") returns a dayTimeDuration value corresponding to 4 days, 9 hours, 8 minutes, and 20 seconds, as shown in the following example query:
let $mydur := xf:dayTimeDuration("P4DT9H8M20S") return <components> <days>{xf:get-days-from-dayTimeDuration($mydur)}</days> <hours>{xf:get-hours-from-dayTimeDuration($mydur)}</hours> <minutes>{xf:get-minutes-from-dayTimeDuration($mydur)}</minutes> <seconds>{xf:get-seconds-from-dayTimeDuration($mydur)}</seconds> </components>
The preceding query, generates the following XML result:
<components> <days>4</days> <hours>9</hours> <minutes>8</minutes> <seconds>20</seconds> </components>
Invoking dayTimeDuration("PT2H20S") returns a dayTimeDuration value corresponding to 2 hours and 20 seconds, as shown in the following example query:
let $mydur := xf:dayTimeDuration("PT2H20S")
return
<components>
<days>{xf:get-days-from-dayTimeDuration($mydur)}</days>
<hours>{xf:get-hours-from-dayTimeDuration($mydur)}</hours>
<minutes>{xf:get-minutes-from-dayTimeDuration($mydur)}</minutes>
<seconds>{xf:get-seconds-from-dayTimeDuration($mydur)}</seconds>
</components>
The preceding query, generates the following XML result:
<components> <days>0</days> <hours>2</hours> <minutes>0</minutes> <seconds>20</seconds> </components>
Invoking dayTimeDuration("-P10D") returns a dayTimeDuration value corresponding to negative 10 days, as shown in the following example query:
let $mydur := xf:dayTimeDuration("-P10D")
return
<components>
<days>{xf:get-days-from-dayTimeDuration($mydur)}</days>
<hours>{xf:get-hours-from-dayTimeDuration($mydur)}</hours>
<minutes>{xf:get-minutes-from-dayTimeDuration($mydur)}</minutes>
<seconds>{xf:get-seconds-from-dayTimeDuration($mydur)}</seconds>
</components>
The preceding query, generates the following XML result:
<components> <days>-10</days> <hours>0</hours> <minutes>0</minutes> <seconds>0</seconds> </components>
W3C dayTimeDuration data type description.