fn:days-from-duration 関数

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

構文

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

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

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

戻り値

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

  • duration-value が xs:dayTimeDuration タイプまたは xs:duration タイプの場合、戻り値は xs:integer タイプであり、 xs:dayTimeDuration としてキャストされた duration-value の 日付コンポーネントです。duration-value が負の数の場合、戻り値も 負の数です。
  • duration-value が xs:yearMonthDuration タイプの場合、 戻り値は 0 です。

  • duration-value が空シーケンスである場合、戻り値は空シーケンスです。

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

例

この関数は、 -10 日と 0 時間の期間の日付コンポーネントを 戻します。

fn:days-from-duration(xs:dayTimeDuration("-P10DT00H"))

戻り値は -10 です。

この関数は、3 日と 55 時間の期間の 日付コンポーネントを戻します。

fn:days-from-duration(xs:dayTimeDuration("P3DT55H"))

戻り値は 5 です。期間内の総日数を計算する場合、 55 時間は 2 日と 7 時間に変換します。期間は P5D7H に等しく、P5D7H の日付コンポーネントは 5 日です。