fn:seconds-from-duration 関数
fn:seconds-from-duration 関数は、 期間の秒コンポーネントを戻します。
構文
>>-fn:seconds-from-duration(duration-value)--------------------><
- duration-value
- 秒コンポーネントの抽出元の期間値。
duration-value は、空のシーケンスか、または xs:dayTimeDuration、 xs:duration、xs:yearMonthDuration のいずれかのタイプの値です。
戻り値
戻り値は、 以下のように、duration-value のタイプによって決まります。
- duration-value が xs:dayTimeDuration タイプまたは xs:duration タイプの場合、戻り値は xs:decimal タイプであり、 -60 より大きく 60 未満の値です。値は、 xs:dayTimeDuration としてキャストされた duration-value の秒コンポーネント (小数部分を含む) です。duration-value が負の場合、値は負になります。
- duration-value が xs:yearMonthDuration タイプの場合、 戻り値は xs:integer タイプの 0 です。
- duration-value が空シーケンスである場合、戻り値は空シーケンスです。
xs:dayTimeDuration と してキャストされた duration-value の秒コンポーネント (小数部分を含む) は、(S mod 60) として計算されます。値 S は、年コンポーネントおよび月コンポーネントを 除去するために xs:dayTimeDuration としてキャストされた duration-value の秒の総数 (小数部分を含む) です。
例
次の関数は、 期間が 150.5 秒の秒コンポーネントを戻します。
fn:seconds-from-duration(xs:dayTimeDuration("PT150.5S"))
戻り値は 30.5 です。期間内の総秒数を計算する場合、 150.5 秒は 2 分と 30.5 秒に 変換します。期間は PT2M30.5S に等しく、PT2M30.5S の秒コンポーネントは 30.5 秒です。
