xs:dayTimeDuration

データ・タイプ xs:dayTimeDuration は、日、時間、分、および 秒のコンポーネントによって表現される期間を表します。 xs:dayTimeDuration は、データ・タイプ xs:duration から派生しています。

このデータ・タイプによって表現可能な範囲は -P11574074073DT23H163M219.999999999999S から P11574074073DT23H163M219.999999999999S まで (つまり -999999999999999.999999999999 秒から 999999999999999.999999999999 秒まで) です。

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

P
期間指定子。
nD
n は日数を示す符号なし 整数です。
T
日時の区切り記号。
nH
n は時間数を示す符号なし 整数です。
nM
n は分数を示す符号なし 整数です。
nS
n は秒数を示す符号なし 10 進数です。小数点が表示される場合、小数秒を示す 1 から 12 桁の数字が小数点の後に必要です。
例えば、次の形式は、3 日と 10 時間 30 分の期間を示します。
P3DT10H30M
次の形式は、マイナス 120 日の期間を示します。
-P120D

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

この形式で精度を低くしたり、表記を切り捨てたりすることは可能ですが、 以下の要件に準拠する必要があります。

  • 任意の式で日、時間、分、または秒の数値がゼロである場合は、その数値および対応する指定子を省略できます。 ただし、数値およびその指定子少なくとも 1 つが存在する必要があります。
  • 秒部分は、10 進の小数部を持つことができます。
  • 時間項目を 1 つも指定しない場合に限っては、指定子 T が存在しない必要があります。指定子 P は常に存在する 必要があります。
例えば、以下の形式は許可されます。
P13D
PT47H
P3DT2H
-PT35.89S
P4DT251M

形式 P-134D は許可されません が、形式 -P1347D は許可されます。

Db2® データベース・システムでは、正規形で xs:dayTimeDuration 値を保管します。正規形では、秒および分のコンポーネント は 60 未満で、時間コンポーネントは 24 未満です。Db2 では、60 秒の倍数ごとを 1 分に変換し、60 分の倍数ごとを 1 時間に変換し、24 時間の倍数ごとを 1 日に変換します。例えば、次の XQuery 式では、63 日と 55 時間 81 秒の dayTimeDuration を指定してコンストラクター関数を呼び出します。

xs:dayTimeDuration("P63DT55H81S")

Db2 は 55 時間を 2 日と 7 時間に変換し、81 秒を 1 分と 21 秒に変換します。この式は、正規化された dayTimeDuration 値 P65DT7H1M21S を戻します。