setDateValue (DOMDocument - JavaScript)

Sets the date and time value of an element.

Defined in

DOMDocument

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:

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