setDateValue (DOMElement - JavaScript)

Sets the date and time value of an element.

Defined in

DOMElement

Syntax

setDateValue(value:Date) : void

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

The signatures with an XPath are equivalent to setDateValue in DOMDocument.

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.

The signatures with an XPath generate a hierarchy of elements to meet the XPath specification. For example, the specification setDateValue(new Date(2007, 2, 1)) generates the following XML:
<schema0>
  <element0>2007-03-01T00:00:00-05:00</element0>
</schema0>

The signature without an XPath sets the value for the current element as it exists in the current hierarchy.

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

Examples

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();
var schema0 = dom.createElement("schema0");
var element0 = dom.createElement("element0");
dom.appendChild(dom.createComment("DOM comment"));
dom.appendChild(schema0);
schema0.appendChild(dom.createComment("Schema comment"));
schema0.appendChild(element0);
element0.setDateValue(requestScope.d);
element0.appendChild(dom.createComment("Element comment"));
doc.save()
The generated XML is as follows:
<!--DOM comment-->
<schema0>
  <!--Schema comment-->
  <element0>2007-03-01T00:00:00-05:00
    <!--Element comment-->
  </element0>
</schema0>