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 年です。
