setDateValue (DOMDocument - JavaScript)

Sets the date and time value of an element.

Defined in

Syntax

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

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


Parameters	Description
`xpath`	XPath of an element in the document.
`value`	The value to be set.
`selectionNS`	A namespace context.

Usage

This method is equivalent to the XPath signatures of setDateValue in DOMElement.

In a schema, this data element should be defined as date, time, or dateTime. In the data properties, the display type of a bound field should be Date/Time.

This method generates a hierarchy of elements to meet the XPath specification. For example, the specification

setDateValue("/schema0/element0",
new Date(2007, 2, 1))

generates the following XML:

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

This method replaces all content including child nodes. Append child nodes after calling this method, not before.

If the XPath includes namespace prefixes, either:

Define the namespaces in the third parameter, first creating a new DOMNamespaceContextImpl object and adding the namespaces with addNamespace.
Define the namespaces with setSelectionNamespaces before using this method without the third parameter.

Examples

(1) This example is for the onclick event of a button. It creates a document and sets a value. The requestScope variable is bound to an edit box on the page so the user specifies d before clicking the button.

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

(2) This example is for the onclick event of a button. It creates a document and sets a value using namespaces. The requestScope variable is bound to an edit box on the page so the user specifies d before clicking the button.

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()