timeプロパティ

mdex:timeプロパティは、毎日繰り返される特定の時刻を表します。

mdex:timeプロパティは、特定時刻の時間と分を表します(オプションで小数秒を指定できます)。時間の値は、世界標準時(UTC)として、またはローカル時間とUTCタイムゾーン・オフセットとして指定できます。ローカル時間のみの指定はサポートされません。

世界標準時の書式

UTC時刻のmdex:timeの書式は次のとおりです。
hh ':' mm ':' ss {'.' s+} Z
変数の意味は次のとおりです。
  • hhは、時間を表す2桁の数値です。ただし、24を指定することはできません(24を表すには、時刻部分をすべて0にします)。
  • mmは、分を表す2桁の数値です。
  • ssは、整数秒を表す2桁の数値です。
  • '.' s+はオプションで、指定があれば小数秒を表します。内部表現はミリ秒までの精度であり、4桁以上を指定しても3桁に切り捨てられます。
  • Z (空白なしで時刻に追加)は、この時刻が協定世界時(UTC、グリニッジ標準時とも呼ばれる)であることを示すリテラルのインジケータです。Zは、UTCオフセットが0であることを示すゾーン指定子です。

コロン(':')は時間、分、整数秒のセパレータで、ピリオド('.')は小数秒のセパレータです。1桁の時間、分、整数秒には、必ず先頭に0を付けてください。

たとえば、ニューヨーク市の午後1:30を示すには、次のように指定します。
18:30:00Z

ローカル時間とUTCオフセットの書式

別の方法として、mdex:timeプロパティの値をローカル時間とUTCオフセットで指定できます。この表現の書式は次のとおりです。
hh ':' mm ':' ss {'.' s+} zzzzzz

時間、分および秒の意味は、世界標準時の書式と同じです。zzzzzzがタイムゾーンを表します。タイムゾーンは、時間と分の期間です。タイムゾーンは、正または負の期間として指定できます。

タイムゾーンの書式は次のとおりです。
('+' | '-') hh ':' mm
変数の意味は次のとおりです。
  • hhは、時間を表す2桁の数値です(必要に応じて先頭に0を付けます)。hhの値は、14より大きくすることはできません。
  • mmは、分を表す2桁の数値です。mmの値は59より大きくすることはできません。ただし、hhが14の場合は、mmを00にする必要があります。
  • '+'は、負ではない期間を示します。
  • '-'は、正ではない期間を示します。
たとえば、ニューヨーク市の午後1:30を示すには、次のように指定します。
13:30:00+05:00

timeプロパティの収集の例

次のリクエストでは、2つのtimeプロパティを使用してレコード624が更新されます。
<ns:ingestChanges>
<ns:updateRecords>
 <ns:recordSpecifier>FactSalesID='624'</ns:recordSpecifier>
   <ns:addAssignments>
     <ns1:attribute name="time1" type="mdex:time">13:25:43.261Z</ns1:attribute>
     <ns1:attribute name="time2" type="mdex:time">09:00:00+05:00</ns1:attribute>
    </ns:addAssignments>
   </ns:updateRecords>
 </ns:ingestChanges>

time2プロパティでは、先頭に0を使用して(09)時間を指定していることに注意してください。先頭の0を省略すると、操作に失敗します。