最初に createDateTime で DateTime オブジェクトを作成し、次に setLocalTime と setLocalDate を使用して日付と時刻をリセットします。createDateTime メソッドには String 型、java.util.Date 型、または java.util.Calendar 型のパラメータを指定します。setLocalTime の 1 つのフォームには String 型のパラメータを指定し、もう 1 つのフォームには java.util.Date 型のパラメータを指定し、3 つ目のフォームには java.util.Calendar 型のパラメータを指定します。setLocalTime と setLocalDate のその他のフォームでは int 型のパラメータを複数指定します。

日付パラメータの String 型のフォームは日付、スペース、時刻と続きます。時刻のない日付や日付のない時刻も指定できますが、タイムゾーンは設定されません。後述の「タイムゾーン」を参照してください。

日付と時刻を文字列値から指定すると、次の条件が適用されます。

日付と時刻の部分は、可能であれば、オペレーティングシステムの地域設定に従って解釈されます。たとえば日付の地域設定が M/d/yy である場合、「3/4/05」は 2005 年 3 月 4 日になります。
地域設定を使用して日付と時刻の解釈ができない場合は、うまく機能するものが見つかるまで代わりの設定を試します。たとえば、日付の地域設定が M/d/yy の場合、「13/4/05」は (代わりの「d/M/yy」設定を使用して) 2005 年 4 月 13 日になります。また、この場合「13/33/05」は (代わりの「d/yy/M」設定を使用して) 2033 年 5 月 13 日になります。
どの設定を使用しても日付または時刻を解釈できない場合は、例外NOTES_ERR_INVALID_DATE (4045) が発生します。

地域設定に依存することを避けるには、java.util.Calendar クラスを使用できます。たとえば getInstance およびいずれかの set メソッドを使用し、createDateTime のパラメータを作成できます。

タイムゾーン

DateTime オブジェクトを新規に作成すると、Lotus Domino のタイムゾーン設定によって TimeZone プロパティが決められます。たとえば、Lotus Domino のタイムゾーンが東部標準時間に設定されているコンピュータでコードが実行されるときは、新規の DateTime オブジェクトの TimeZone プロパティは自動的に 5 に設定されます。GMTTime プロパティと LSGMTTime プロパティも Lotus Domino のタイムゾーンの設定によって決められます。

時刻の要素または日付の要素のない日付を作成すると、タイムゾーンは無効となり TimeZone プロパティは 0 を返します。この場合、LocalTime と GMTTime の両方のプロパティはタイムゾーンが設定されていないため同じ時刻値を返します。convertToZone を適用すると、タイムゾーンは無効のまま、また TimeZone も 0 で変わらず、エラーは発生しません。

Today、Tomorrow、および Yesterday

「Today」、「Tomorrow」、「Yesterday」などの式を使用して新しい DateTime オブジェクトを作成する場合、日付の値は Lotus Domino での現在の日付設定を使用して決定されます。このような式は DateTime オブジェクトの時刻の部分には影響を与えません。DateTime を現在の日付と時刻に設定するには、「Today」または「Yesterday」の後に時刻を指定する (「Today 12:00:00 AM」など) か、または setNow を使用します。

アクセス方法

Lotus Domino 文書のアイテム内に格納されている日付/時刻値にアクセスするには、Item の getDateTimeValue を使用します。

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

例

関連項目

ライブラリー | サポート | ご利用条件 |

最終更新日: 2009 年 10 月 5 日 (月曜日)