JAVA/CORBA クラス


DateTime クラス

日付と時刻を表します。

構文
public class DateTime extends Base

包含関係
スーパークラス:AgentContextDatabaseDateRangeDateTimeDocumentSessionView

プロパティ
DateOnly (getDateOnly を使用)

GMTTime (getGMTTime を使用)

IsDST (isDST を使用)

LocalTime (getLocalTime、setLocalTime、および setLocalDate を使用)

Parent (getParent を使用)

TimeOnly (getTimeOnly を使用)

TimeZone (getTimeZone を使用)

ZoneTime (getZoneTime を使用)

メソッド
adjustDay

adjustHour

adjustMinute

adjustMonth

adjustSecond

adjustYear

convertToZone

recycle

setAnyDate

setAnyTime

setNow

timeDifference

toJavaDate

toString

作成方法
新しい DateTime オブジェクトを作成するには、Session の createDateTime を使います。

使用法
最初に 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 型のフォームは日付、スペース、時刻と続きます。時刻のない日付や日付のない時刻も指定できますが、タイムゾーンは設定されません。後述の「タイムゾーン」を参照してください。

String 型のパラメータの日付の要素は、以下の形式のいずれかです。「/」は、オペレーティングシステムの日付区切り文字を表します。


String 型のパラメータの時刻の要素は、以下の形式のいずれかです。「:」は、オペレーティングシステムの時刻区切り文字を表します。秒の要素の SS はオプションです。24 時間制を使っている場合、「AM」と「PM」は無視されます。
タイムゾーン
NotesDateTime オブジェクトを新規に作成すると、Domino のタイムゾーンの設定によって TimeZone プロパティが決められます。たとえば、Domino のタイムゾーンが東部標準時間に設定されているコンピュータでコードが実行されるときは、新規の NotesDateTime オブジェクトの TimeZone プロパティは自動的に 5 に設定されます。GMTTime プロパティと LSGMTTime プロパティも Domino のタイムゾーンの設定によって決められます。

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

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

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

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


関連項目