時刻を処理する

DateTime クラスは、日時を表します。DateTime オブジェクトを作成するには、Session の createDateTime を使用します。lotus.domino パッケージのさまざまなメソッドにより、DateTime オブジェクトが返されます。

次のメソッドにより、DateTime の各プロパティにアクセスします。

• getLocalTime は、ローカル時間での Notes の日付/時刻を含む String 型の値を返します。String パラメータを指定して setLocalTime メソッドを実行すると、日付/時刻は String の表すローカル時間に設定されます。int パラメータを指定して setLocalTime メソッドを実行すると、日付/時刻の時刻部分が設定されます。int パラメータを指定して setLocalDate メソッドを実行すると、日付/時刻の日付部分が設定されます。
• getGMTTime は、グリニッジ標準時での Notes の日付/時刻を含む String 型の値を返します。
• getDateOnly は、ローカル時間での Notes の日付/時刻の日付部分を含む String 型の値を返します。
• getTimeOnly は、ローカル時間での Notes の日付/時刻の時刻部分を含む String 型の値を返します。
• getTimeZone は、日付/時刻のタイムゾーンを含む int 型の値を返します。setTimeZone は、タイムゾーンを設定します。
• getZoneTime は、タイムゾーンとサマータイム用に調整された日付/時刻を含む String 型の値を返します。この値は、convertToZone で変換できます。
• isDST は、日付/時刻がサマータイムを反映している場合は true を返します。
• getParent は、現在のセッションを表す Session オブジェクトを返します。

次のメソッドにより、日付/時刻を変更できます。adjustSecond、adjustMinute、adjustHour、adjustDay、adjustMonth、adjustYear。次のメソッドにより、日付/時刻または日付/時刻の各部分を初期化できます。setNow、setAnyDate、および setAnyTime。timeDifference により、2 つの時間の差異を秒単位で取得できます。toJavaDate により、日付/ 時刻を java.util.Date 型のオブジェクトに変換できます。

DateRange クラスは、日付の範囲を表します。次のメソッドにより、DateTime の各プロパティにアクセスします。

• getEndDateTime は、範囲の終了日を表す DateTime オブジェクトを返します。setEndDateTime は、DateTime オブジェクト指定での範囲の終了日を設定します。
• getStartDateTime は、範囲の開始日を表す DateTime オブジェクトを返します。setStartDateTime は、DateTime オブジェクト指定での範囲の開始日を設定します。
• getText は、範囲 (ハイフンで区切られた String 形式の 2 つの日付/時刻) を含む String 型の値を返します。setText は、String 型の値指定での範囲を設定します。
• getParent は、現在のセッションを表す Session オブジェクトを返します。

DateRange オブジェクトを設定する場合は、StartDate と EndDate に書き込むか、あるいは Text に書き込むかのいずれかで、両方には書き込みません。StartDate と EndDate に書き込まれた値は、即座に Text に転写されます。同様に、Text に書き込まれた値は即座に StartDate と EndDate に転写されます。StartDateTime や EndDateTime の元になる DateTime オブジェクトに行われた変更もまた、DateRange オブジェクトに影響します。