fn:hours-from-duration 関数
fn:hours-from-duration 関数は、 期間値の時間コンポーネントを戻します。
構文
>>-fn:hours-from-duration(duration-value)----------------------><
- duration-value
- 時間コンポーネントの抽出元の期間値。
duration-value は空シーケンスであるか、 xs:dayTimeDuration、xs:duration、または xs:yearMonthDuration タイプのいずれかの値です。
戻り値
戻り値は、 以下のように、duration-value のタイプによって決まります。
- duration-value が xs:dayTimeDuration タイプまたは xs:duration タイプの場合、戻り値は xs:integer タイプであり、 -23 から 23 (両端を含む) の範囲内の値です。値は、xs:dayTimeDuration としてキャストされた duration-value の時間コンポーネントです。 duration-value が負の場合、値は負になります。
- duration-value が xs:yearMonthDuration タイプの場合、 戻り値は xs:integer タイプの 0 です。
- duration-value が空シーケンスである場合、戻り値は空シーケンスです。
xs:dayTimeDuration としてキャストされた duration-value の時間コンポーネントは、 ((S mod 86400) idiv 3600) で計算された時間数 (整数) です。値 S は、日コンポーネント および月コンポーネントを削除するために xs:dayTimeDuration としてキャストされた duration-value の 秒の総数です。86400 の値は、 1 日の秒数で、3600 は 1 時間の 秒数です。
例
次の関数は、 126 時間の期間の時間コンポーネントを 戻します。
fn:hours-from-duration(xs:dayTimeDuration("PT126H"))
戻り値は 6 です。 期間内の総時間数を計算する場合、126 時間は 5 日と 6 時間に変換します。期間は P5DT6H に等しく、 P5DT6H の時間コンポーネントは 6 時間です。
