getDateValue (DOMDocument - JavaScript)

Gets the date and time value of the first data element that matches an XPath.

Defined in

DOMDocument

Syntax

getDateValue(xpath:string) : Date

getDateValue(xpath:string, selectionNS:NamespaceContext) : Date

Parameters Description
xpath The XPath of an element associated with the document.
selectionNS A namespace context.
Return value Description
Date The value of the data element.

Usage

This method is equivalent to getDateValue 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.

If the XPath includes namespace prefixes, either:

Examples

(1) This example is for the onclick event of a button. It gets an element from the document specified by an index. The requestScope variables are bound to edit boxes on the page so the user specifies i before clicking the button, and gets back d or msg.
var dc = database.getAllDocuments();
if(dc.getDocumentCount() > 0) {
	if(requestScope.i >= 0 && requestScope.i < dc.getDocumentCount()) {
		var ar = dc.getDocumentArray(requestScope.i + 1);
		var doc = ar[i];
		var dom = doc.getDOM();
		requestScope.d = dom.getDateValue("/schema1/element4");
	} else {
		requestScope.msg = "No such document";
	}
} else {
	requestScope.msg = "No documents in database";
}
(2) This example is for the onclick event of a button. It gets an element from the document specified by an index using namespaces. The requestScope variables are bound to edit boxes on the page so the user specifies i before clicking the button, and gets back d or msg.
var dc = database.getAllDocuments();
if(dc.getDocumentCount() > 0) {
	if(requestScope.i >= 0 && requestScope.i < dc.getDocumentCount()) {
		var ar = dc.getDocumentArray(requestScope.i + 1);
		var doc = ar[i];
		var dom = doc.getDOM();
		var ns = new NamespaceContextImpl();
		ns.addNamespace("s", "http://mynamespace.com");
		requestScope.d = dom.getDateValue("/s:schema1/s:element4", ns);
	} else {
		requestScope.msg = "No such document";
	}
} else {
	requestScope.msg = "No documents in database";
}