setDateValue (DOMDocument - JavaScript)

エレメントの日時値を設定します。

定義場所

構文

setDateValue(xpath:string, value:Date) : void

setDateValue(xpath:string, value:Date, selectionNS:NamespaceContext) : void

パラメータ	説明
`xpath`	文書内のエレメントの XPath です。
`value`	設定する値です。
`selectionNS`	namespace コンテキストです。

使用法

このメソッドは、DOMElement の setDateValue の XPath シグニチャと同等です。

スキーマでは、このデータエレメントを date、time、dateTime と定義する必要があります。データプロパティでは、関連あるフィールドの表示タイプが Date/Time でなければなりません。

このメソッドは、XPath 指定に合致するエレメントの階層を生成します。例えば、setDateValue("/schema0/element0", new Date(2007, 2, 1)) と指定すると以下の XML が生成されます。

<schema0>
  <element0>2007-03-01T00:00:00-05:00</element0>
</schema0>

このメソッドは、下位ノードを含むすべての内容を置き換えます。このメソッドを呼び出す前ではなく、呼び出した後に下位ノードを付加します。

XPath が名前空間プレフィックスを含む場合は、以下のいずれかに従ってください。

第 3 パラメータで名前空間を定義し、最初に新規の DOMNamespaceContextImpl オブジェクトを作成してから addNamespace で名前空間を追加する。
setSelectionNamespaces で名前空間を定義してから、第 3 パラメータを指定せずにこのメソッドを使用する。

例

(1) これは、ボタンの onclick イベントの例です。この例では、文書を作成し、値を設定します。requestScope 変数がページの編集ボックスにバインドされているため、ユーザーは d を指定してからボタンをクリックします。

var doc = database.createNewDocument();
var dom = doc.getDOM();
dom.setDateValue("/schema1/element4", requestScope.d);
doc.save()

(2) これは、ボタンの onclick イベントの例です。文書を作成し、名前空間を使用して値を設定します。requestScope 変数がページの編集ボックスにバインドされているため、ユーザーは d を指定してからボタンをクリックします。

var doc = database.createNewDocument();
var dom = doc.getDOM();
var ns = new NamespaceContextImpl();
ns.addNamespace("s", "http://mynamespace.com");
dom.setDateValue("/s:schema1/s:element4", requestScope.d, ns);
doc.save()