fn:minutes-from-duration 関数

fn:minutes-from-duration 関数は、 期間の分コンポーネントを戻します。

構文

構文図を読む
>>-fn:minutes-from-duration(duration-value)--------------------><

duration-value
分コンポーネント抽出元の期間値。

duration-value は、空のシーケンスか、または xs:dayTimeDuration、 xs:duration、xs:yearMonthDuration のいずれかのタイプの値です。

戻り値

戻り値は、 以下のように、duration-value のタイプによって決まります。

  • duration-value が xs:dayTimeDuration タイプまたは xs:duration タイプの場合、戻り値は xs:integer タイプであり、 -59 から 59 (両端を含む) の範囲内の値です。値は、xs:dayTimeDuration としてキャストされた duration-value の分コンポーネントです。 duration-value が負の場合、値は負になります。
  • duration-value が xs:yearMonthDuration タイプの場合、 戻り値は 0 です。
  • duration-value が空シーケンスである場合、戻り値は空シーケンスです。

xs:dayTimeDuration として キャストされた duration-value の分コンポーネントは、 ((S mod 3600) idiv 60) として計算された分数 (整数) です。値 S は、 年コンポーネントおよび月コンポーネントを除去するために xs:dayTimeDuration として キャストされた duration-value の秒の総数です。

例

次の関数は、 2 日と 16 時間 93 分の期間の分コンポーネントを戻します。

fn:minutes-from-duration(xs:dayTimeDuration("P2DT16H93M"))

戻り値は 33 です。期間内の総分数を計算する場合、 93 分は 1 時間 33 分に変換します。 期間は P2DT17H33M に等しく、P2DT17H33M の分コンポーネントは 33 分です。