fn:years-from-duration 関数

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

構文

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

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

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

戻り値

戻り値は、 以下のように、duration-value のタイプによって決まります。
  • duration-value が xs:yearMonthDuration タイプまたは xs:duration タイプの場合、戻り値は xs:integer タイプです。 値は、xs:yearMonthDuration としてキャストされた duration-value の 年コンポーネントです。duration-value が負の場合、値は負になります。
  • duration-value が xs:dayTimeDuration タイプの場合、 戻り値は xs:integer タイプの 0 です。
  • duration-value が空シーケンスである場合、戻り値は空シーケンスです。

xs:yearMonthDuration として キャストされた duration-value の 年コンポーネントは、年数 (整数) です。これは、xs:yearMonthDuration としてキャストされた duration-value の次の総数を12 で除算することにより 決まります。

例

次の関数は、 -4 年 -11 カ月 -320 日の期間の 年コンポーネントを 戻します。

fn:years-from-duration(xs:duration("-P4Y11M320D"))

戻り値は -4 です。

次の関数は、 9 年と 13 カ月の期間の年コンポーネントを戻します。

fn:years-from-duration(xs:yearMonthDuration("P9Y13M"))

戻り値は 10 です。期間内の総年数を計算する場合、 13 カ月は 1 年と 1 カ月に変換します。期間は、 P10Y1M に等しく、P10Y1M の年コンポーネントは 10 年です。