NotesDateRange (JavaScript)

日時の範囲を表します。

作成方法

新規 NotesDateRange オブジェクトを作成するには、NotesSession 内の createDateRange を使用します。オブジェクトを初期化するには、以下のいずれかを実行します。

createDateRange パラメータに値を割り当てる。
StartDateTime と EndDateTime に値を割り当てる。
日付範囲を表すストリング値を Text に割り当てる。この値は、2 つの日付/時刻値のストリング表現をハイフンで区切ったものです (例えば「01/01/11 - 01/02/11」)。

使用法

StartDateTime または EndDateTime を割り当てると、その値によって Text 内の対応する値が置き換わります。Text 内の値を割り当てると、StartDateTime または EndDateTime の値が置き換わります。

例

以下の計算結果フィールドは、2 つの日付/時刻値から日時の範囲を作成し、そのテキスト値を返します。

var doc:NotesDocument = currentDocument.getDocument();
var created:NotesDateTime = doc.getCreated();
var last:NotesDateTime = doc.getLastAccessed();
var range:NotesDateRange = session.createDateRange(created, last);
return "Life span of this document: " + range.getText()

以下の計算結果フィールドは、日時の範囲を作成し、2 つの日付/時刻値によって範囲の開始値と終了値を設定して、そのテキスト値を返します。

var doc:NotesDocument = currentDocument.getDocument();
var created:NotesDateTime = doc.getCreated();
var last:NotesDateTime = doc.getLastAccessed();
var range:NotesDateRange = session.createDateRange();
range.setStartDateTime(created);
range.setEndDateTime(last);
return "Life span of this document: " + range.getText()

以下の計算結果フィールドは、2 つの日付値から日時の範囲を作成し、そのテキスト値を返します。

var doc:NotesDocument = currentDocument.getDocument();
var created:Date = doc.getCreated().toJavaDate();
var last:Date = doc.getLastAccessed().toJavaDate();
var range:NotesDateRange = session.createDateRange(created, last);
return "Life span of this document: " + range.getText()

以下の計算結果フィールドは、日時の範囲を作成し、そのテキスト値を設定して、範囲の開始値と終了値に基づく日数を返します。さらに、親セッションの共通名も返します。

var doc:NotesDocument = currentDocument.getDocument();
var created:string = doc.getCreated().getLocalTime();
var last:string = doc.getLastAccessed().getLocalTime();
var range:NotesDateRange = session.createDateRange();
range.setText(created + " - " + last);
//return range.getText()
return "Created on " + 	range.getStartDateTime().getDateOnly() +
	", last accessed on " + range.getEndDateTime().getDateOnly() +
	", current user " + range.getParent().getCommonUserName()