ShowTable of Contents
DateTime
This button creates or changes a date-time item in the current document.
var doc:NotesDocument = currentDocument.getDocument();
var dt:NotesDateTime = session.createDateTime("Today 12");
dt.setNow();
doc.replaceItemValue("RecordedTime", dt);
doc.save();
This computed field gets a date-time item from the current document.
var doc:NotesDocument = currentDocument.getDocument();
if (doc.hasItem("RecordedTime")) {
var dt:NotesDateTime = doc.getItemValueDateTimeArray("RecordedTime").elementAt(0);
return dt.getLocalTime() + " (" + dt.getGMTTime() + ")";
} else {
return "No recorded time"
}
DateOnly
This computed field displays the creation date for the current database.
var dt:NotesDateTime = database.getCreated();
return "This database was created on " + dt.getDateOnly();
GMTTime
This computed field displays the creation date for the current database in GMT as well as local time.
var dt:NotesDateTime = database.getCreated();
return "This database was created on " + dt.getLocalTime() +
" (" + dt.getGMTTime() + ")"
IsDST
This computed field displays the creation date for the current database with information on the time zone and daylight savings.
var dt:NotesDateTime = database.getCreated();
return "This database was created on " + dt.getLocalTime() +
" (time zone " + dt.getTimeZone().toFixed() +
(dt.isDST() ? " with" : " without") + " daylight savings)";
LocalTime
This computed field displays the creation date and time of the current database.
var dt:NotesDateTime = database.getCreated();
return "This database was created on " + dt.getLocalTime();
This onclick event for an input box (bound to requestScope.date) sets a date-time value based on user input. A correct date depends on valid user input.
// Create valid NotesDateTime object
var dt:NotesDateTime = session.createDateTime("Today 12");
// requestScope variables are bound to numeric input boxes
// must convert numeric user input to int
var year = parseInt(requestScope.year, 10);
var month = parseInt(requestScope.month, 10);
var day = parseInt(requestScope.day, 10);
var hour = parseInt(requestScope.hour, 10);
var minute = parseInt(requestScope.minute, 10);
var second = parseInt(requestScope.second, 10);
var hundredth = parseInt(requestScope.hundredth, 10);
// Set date and time from user input
try {
dt.setLocalDate(year, month, day, true);
} catch(e) {
requestScope.date = "Illegal specification for date";
return;
}
try {
dt.setLocalTime(hour, minute, second, hundredth);
} catch(e) {
requestScope.date = "Illegal specification for time";
return;
}
// Post local time to input box
requestScope.date = dt.getLocalTime();
This onclick event for an input box (bound to requestScope.date) sets a date-time value based on user input. A correct date depends on a valid user input string.
// Create valid NotesDateTime object
var dt:NotesDateTime = session.createDateTime("Today 12");
// Get date from user and set
dt.setLocalTime(requestScope.dt);
// Display date-time
requestScope.date = dt.getLocalTime();
This onclick event for an input box (bound to requestScope.date) sets a date-time value based on user input. A correct date depends on valid user input.
// Create valid NotesDateTime object
var dt:NotesDateTime = session.createDateTime("Today 12");
// Create Date object (note: January = 0 for Date)
// requestScope variables are bound to numeric input boxes
var date:Date = new Date(requestScope.year, (requestScope.month) - 1, requestScope.day,
requestScope.hour, requestScope.minute, requestScope.second, requestScope.hundredth);
// Set time
dt.setLocalTime(date);
// Post local time
requestScope.date = dt.getLocalTime();
Parent
This computed field displays the creation date for the current database and the user name for the parent session.
var dt:NotesDateTime = database.getCreated();
return "This database was created on " + dt.getLocalTime() +
" (current user is " + dt.getParent().getUserName() + ")"
TimeOnly
This computed field displays the creation date and time for the current database.
var dt:NotesDateTime = database.getCreated();
return "This database was created on " + dt.getDateOnly() + " at " + dt.getTimeOnly();
TimeZone
This computed field displays the creation date for the current database with information on the time zone and daylight savings.
var dt:NotesDateTime = database.getCreated();
return "This database was created on " + dt.getLocalTime() +
" (time zone " + dt.getTimeZone().toFixed() +
(dt.isDST() ? " with" : " without") + " daylight savings)";
ZoneTime
This button converts the current time to all time zones.
var dt:NotesDateTime = session.createDateTime("Today 06:00");
dt.setNow();
requestScope.status = "Zone\tTime";
for (var i = -12; i <= 12; i++) {
dt.convertToZone(i, dt.isDST());
requestScope.status += "\n" +
dt.getTimeZone() + "\t\t" + dt.getZoneTime();
}
adjustDay
This computed field increments a date-time value.
var dt:NotesDateTime = session.createDateTime("Today");
dt.adjustDay(14);
return "Due date: " + dt.getDateOnly();
adjustHour
This button posts a start time given the current time and the elapsed hours, minutes, and seconds.
// Create valid NotesDateTime object and set to current time
var dt:NotesDateTime = session.createDateTime("Today 12");
dt.setNow();
// Get elapsed time
var hours = parseInt(requestScope.hour, 10);
var minutes = parseInt(requestScope.minute, 10);
var seconds = parseInt(requestScope.second, 10);
dt.adjustHour(-hours);
dt.adjustMinute(-minutes);
dt.adjustSecond(-seconds);
// Post start time
requestScope.startTime = dt.getLocalTime();
adjustMinute
See adjustHour.
adjustMonth
This computed field increments a date-time value.
var dt:NotesDateTime = session.createDateTime("Today");
dt.adjustMonth(2);
return "Due date: " + dt.getDateOnly();
adjustSecond
See adjustHour.
adjustYear
This computed field increments a date-time value.
var dt:NotesDateTime = session.createDateTime("Today");
dt.adjustYear(1);
return "Due date: " + dt.getDateOnly();
convertToZone
This button converts the current time to all time zones.
var dt:NotesDateTime = session.createDateTime("Today 06:00");
dt.setNow();
requestScope.status = "Zone\tTime";
for (var i = -12; i <= 12; i++) {
dt.convertToZone(i, dt.isDST());
requestScope.status += "\n" +
dt.getTimeZone() + "\t\t" + dt.getZoneTime();
}
setAnyDate
This computed field displays the creation time of the current document.
var doc:NotesDocument = currentDocument.getDocument();
var dt:NotesDateTime = doc.getCreated();
dt.setAnyDate();
return dt.getLocalTime();
setAnyTime
This computed field displays the creation date of the current document.
var doc:NotesDocument = currentDocument.getDocument();
var dt:NotesDateTime = doc.getCreated();
dt.setAnyTime();
return dt.getLocalTime();
setNow
This button creates or replaces the PurgeDate item in the current document.
var doc:NotesDocument = currentDocument.getDocument();
var dt:NotesDateTime = session.createDateTime("Today 12");
dt.setNow();
dt.adjustMonth(2);
doc.replaceItemValue("PurgeDate", dt);
doc.save();
timeDifference
This computed field returns the number of days since the current document was created.
var doc:NotesDocument = currentDocument.getDocument();
var created:NotesDateTime = doc.getCreated();
var now:NotesDateTime = session.createDateTime("Today 12");
now.setNow();
var days:int = now.timeDifferenceDouble(created) / 86400; // 86400 seconds in a day
return "This document was created " + Math.floor(days) + " days ago."
toJavaDate
This computed field displays the creation date of the current document in ISO format.
var doc:NotesDocument = currentDocument.getDocument();
var dt:NotesDateTime = doc.getCreated();
var jdt:java.util.Date = dt.toJavaDate();
return jdt.toISOString()