NotesDateTime (JavaScript™)

日時を表します。

作成と使用

新規 NotesDateTime オブジェクトを作成するには、NotesSession 内の createDateTime を使用します。有効なオブジェクトを取得するために、有効なパラメータを指定する必要があります。

createDateTime で NotesDateTime オブジェクトを作成した後に、setLocalTime と setLocalDate で日時をリセットすることができます。createDateTime メソッドは、string または Date パラメータを受け取ります。ある形式の setLocalTime は string パラメータを受け取り、別の形式では Date パラメータを受け取ります。その他の形式の setLocalTime と setLocalDate は、複数の int パラメータを受け取ります。

string 形式の日付パラメータは、日付の後にスペースがあり、その後に時刻があります。時刻なしで日付を指定することも、日付なしで時刻を指定することもできますが、タイムゾーンは設定されません (後述の「タイムゾーン」を参照)。

以下の事項は、string 値から日時を設定する場合に該当します。

  • 日付コンポーネントと時刻コンポーネントは、可能な場合はオペレーティングシステムの地域設定に従って解釈されます。例えば、日付の地域設定が M/d/yy である場合、「3/4/05」は 2005 年 3 月 4 日を意味します。
  • 地域設定を使用して日付または時刻を解釈できない場合は、解釈可能な設定が見つかるまで代替の設定が試行されます。例えば、日付の地域設定が M/d/yy である場合、「13/4/05」は 2005 年 4 月 13 日を意味し (代替設定として d/M/yyを使用)、「13/33/05」は 2033 年 5 月 13 日を意味します (代替設定として d/yy/M を使用)。
  • どの設定を使用しても日付または時刻を解釈できない場合、エラーが発生します。

タイムゾーン

新規 NotesDateTime オブジェクトの作成時に、IBM Domino でのタイムゾーン設定によって、TimeZone プロパティが決まります。 例えば、IBM Domino のタイムゾーンが東部標準時に設定されているコンピュータでコードが実行される場合、すべての新規 NotesDateTime オブジェクトの TimeZone プロパティは自動的に 5 に設定されます。タイムゾーン設定は、GMTTime プロパティにも影響します。

時刻コンポーネントなしで、または日付コンポーネントなしで日付を作成した場合、タイムゾーンは無効であり、TimeZone プロパティは 0 を返します。この場合、LocalTime と GMTTime はどちらも、タイムゾーンがない同じ時刻値を返します。convertToZone を適用した場合、タイムゾーンは無効のままで、TimeZone は 0 のままとなります。このとき、エラーは発生しません。

Today、Tomorrow、Yesterday

Today、Tomorrow、Yesterday などの表現を使用して新規 NotesDateTime オブジェクトを作成する場合、日付の値は IBM Domino 内の現在の日付設定を使用して決定されます。これらの表現は、NotesDateTime オブジェクトの時刻コンポーネントに影響を与えません。 NotesDateTime を現在の日時に設定するには、Today の後に時刻を指定 (例えば Today 12:00:00 AM) するか、setNow を使用します。

アクセス

IBM Domino 文書内のアイテムに保管された日時の値にアクセスするには、NotesItem 内の getDateTimeValue を使用するか、NotesDocument 内の getItemValueDateTimeArray を使用します。

NotesInternational クラスを通じて、オペレーティングシステムの日時の区切り文字とタイムゾーン設定を取得できます。

例

このボタンは、現在の文書内の日時のアイテムを作成または変更します。
var doc:NotesDocument = currentDocument.getDocument();
var dt:NotesDateTime = session.createDateTime("Today 12");
dt.setNow();
doc.replaceItemValue("RecordedTime", dt);
doc.save();
以下の計算結果フィールドでは、現在の文書から日時のアイテムを取得します。
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"
}