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 時間です。