durationプロパティ

mdex:durationプロパティは、期間を表します。

mdex:durationプロパティは、日数、時間数、分数による期間を表します。タイムゾーンを時間表現に含めることはできません。

mdex:durationの書式は次のとおりです。
'P' {d 'D'} 'T' {h 'H'} {m 'M'} {s {'.' s+} 'S'}
変数の意味は次のとおりです。
  • Pは、これが期間であることを示す必須リテラルです。
  • d'D'パラメータで、dは日数を指定し、リテラルのDは、これが日数フィールドであることを示します。
  • Tは、いずれかの時間フィールドを指定する場合にのみ指定する必要のあるリテラルの日/時間セパレータです。
  • h'H'パラメータで、hは時間数を指定し、リテラルのHは、これが時間数フィールドであることを示します。
  • m'M'パラメータで、mは分数を指定し、リテラルのMは、これが分数フィールドであることを示します。
  • s'S'パラメータで、sは整数秒数を指定し、リテラルのSは、これが秒数フィールドであることを示します。'.' s+はオプションで、指定があれば小数秒を表します。内部表現はミリ秒までの精度であり、4桁以上を指定しても3桁に切り捨てられます。

すべての期間はオプションですが、少なくとも1つの要素は指定する必要があります。オプションで、負の期間を示すためにマイナス記号('-')を先頭に付けることができます。

durationの書式の例

次の例では、429日と1時間2分3秒という期間を指定しています。
P429DT1H2M3S
次の例では、429日という期間を指定しています。
P429D
次の例では、429日と2分3.25秒という期間を指定しています。
P429DT2M3.25S
次の例では、1時間2分を指定しています。
PT1H2M
次の例では、429日と3秒という負の期間を指定しています。
-P429DT3S

durationプロパティの収集の例

次のリクエストでは、5つのdurationプロパティを使用してレコード344が更新されます。
<ns:ingestChanges>
<ns:updateRecords>
 <ns:recordSpecifier>FactSalesID='344'</ns:recordSpecifier>
   <ns:addAssignments>
     <ns1:attribute name="duration1" type="mdex:duration">P429DT1H2M3S</ns1:attribute>
     <ns1:attribute name="duration2" type="mdex:duration">P429D</ns1:attribute>
     <ns1:attribute name="duration3" type="mdex:duration">P429DT2M3.25S</ns1:attribute>
     <ns1:attribute name="duration4" type="mdex:duration">PT1H2M</ns1:attribute>
     <ns1:attribute name="duration5" type="mdex:duration">-P429DT3S</ns1:attribute>
   </ns:addAssignments>
  </ns:updateRecords>
</ns:ingestChanges>

duration5プロパティは、負の期間値を保持することに注意してください。