UntilTime (NotesDocumentCollection - JavaScript™)

Read-only. The database end time for a collection obtained through getModifiedDocuments in NotesDatabase.

Defined in

NotesDocumentCollection

Syntax

getUntilTime() : NotesDateTime

Usage

This time should be specified as the "since" time in a subsequent call to getModifiedDocuments where you want to get all modified documents since the most recent call.

The database time may differ from the system time. Do not use the system time in getModifiedDocuments where you want to get all modified documents since the most recent call.

For collections not produced through getModifiedDocuments, this property returns null.

Examples

This button gets all documents in the current database modified since the last time the button was clicked.
var profile:NotesDocument = database.getProfileDocument("UntilTimeProfile", null);
if (profile.hasItem("untilTime")) {
	var dt:NotesDateTime = profile.getItemValueDateTimeArray("untilTime")[0];
	var dc:NotesDocumentCollection = database.getModifiedDocuments(dt);
	requestScope.status = "Getting documents since " + dt.getLocalTime();
} else {
	var dc:NotesDocumentCollection = database.getModifiedDocuments(null);
	requestScope.status = "Getting documents since beginning";
}
profile.replaceItemValue("untilTime", dc.getUntilTime());
var doc:NotesDocument = dc.getFirstDocument();
while (doc != null) {
	requestScope.status += "\n" + doc.getItemValueString("subject");
	var tmpdoc = dc.getNextDocument();
	doc.recycle();
	doc = tmpdoc;
}