xs:yearMonthDuration

データ・タイプ xs:yearMonthDuration は、グレゴリオの年および 月のコンポーネントによって表現される期間を表します。 xs:yearMonthDuration は、データ・タイプ xs:duration から派生しています。

このデータ・タイプによって表現可能な範囲は -P83333333333333Y3M から P83333333333333Y3M まで (つまり -999999999999999 カ月から 999999999999999 カ月まで) です。

xs:yearMonthDuration の字句形式は、PnYnM で、これは ISO 8601 形式の還元型です。以下の省略形はこの形式を説明しています。

P
期間指定子。
nY
n は年数を示す符号なし 整数です。
nM
n は月数を示す符号なし 整数です。

オプションの先行する負符号 (-) は、マイナスの期間 を示します。符号を省略した場合は、正の期間が想定されます。

例えば、次の形式は、1 日と 2 カ月の期間を示します。
P1Y2M
次の形式は、マイナス 13 カ月の期間を示します。
-P13M
この形式で精度を低くしたり、表記を切り捨てたりすることは可能ですが、 以下の要件に準拠する必要があります。
  • 指定子 P は常に存在する必要があります。
  • 任意の式で年または月の数値がゼロである場合は、その数値および対応する指定子を省略できます。 ただし、数値およびその指定子 (Y または M) 少なくとも 1 つが存在する必要があります。
例えば、以下の形式は許可されます。
P1347Y
P1347M

形式 P-1347M は許可されません が、形式 -P1347M は許可されます。形式 P24YM は、許可されません。これは、M に先行する数字が 1 つ必要であるためです。PY43M は、許可されません。これは、Y に先行する数字が 1 つ以上必要であるためです。

Db2® は、正規形で xs:yearMonthDuration 値を保管します。 正規形では、月のコンポーネント は 12 未満です。Db2 は、12 カ月の倍数ごとを 1 年に変換します。例えば、次の XQuery 式では、20 年と 30 カ月の yearMonthDuration を指定するコンストラクター関数を呼び出します。

xs:yearMonthDuration("P20Y30M")

Db2 は 30 カ月を 2 年と 6 カ月に変換します。この式は、正規化された yearMonthDuration 値 P22Y6M を戻します。