java.lang.Object
java.util.Date
java.sql.Date
- すべての実装されたインタフェース:
Serializable
,Cloneable
,Comparable<Date>
public class Date extends Date
ミリ秒の値をラップする薄いラッパーであり、これによってJDBCがミリ秒の値をSQL DATE
値として扱うことができるようになります。 ミリ秒の値は、1970年1月1日グリニッジ標準時00:00:00.000からの経過時間をミリ秒で表した数値です。
SQL DATE
の定義に対応させるために、java.sql.Date
のインスタンスでラップされたミリ秒の値は、インスタンスが関連した特定のタイムゾーンで時間、分、秒、ミリ秒をゼロに設定することで、「標準化」する必要があります。
- 導入されたバージョン:
- 1.1
- 関連項目:
-
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明int
getHours()
非推奨。int
非推奨。int
非推奨。void
setHours
(int i) 非推奨。void
setMinutes
(int i) 非推奨。void
setSeconds
(int i) 非推奨。void
setTime
(long date) 指定されたミリ秒の値を使って、既存のDate
オブジェクトを設定します。このメソッドは常にUnsupportedOperationExceptionをスローします。SQLDate
値は時間コンポーネントを持たないので、このメソッドは使わないでください。このDate
オブジェクトから年、月、日を使用してLocalDate
インスタンスを作成します。toString()
日付エスケープ形式yyyy-mm-ddに整形します。static Date
JDBC日付エスケープ形式の文字列をDate
値に変換します。static Date
指定されたLocalDate
と同じ年、月、および月間通算日の値を持つDate
のインスタンスをLocalDate
オブジェクトから取得します。
-
コンストラクタの詳細
-
Date
@Deprecated(since="1.2") public Date(int year, int month, int day) 非推奨。代わりに、コンストラクタDate(long date)
を使用します指定された年、月、日で初期化されたDate
オブジェクトを構築します。指定された引数が範囲外にある場合、結果は定義されません。
- パラメータ:
year
- 年から1900を引いたもの。0から8099まででなければならない。 (8099は9999から1900を引いた値。)month
- 0 - 11day
- 1 - 31
-
Date
public Date(long date) 指定されたミリ秒の値を使ってDate
オブジェクトを構築します。 指定されたミリ秒の値に時間の情報が含まれている場合、ドライバは時間コンポーネントをデフォルトのタイムゾーン(アプリケーションを実行しているJava仮想マシンのタイムゾーン)の時間に設定します。この時間はゼロGMT (グリニッジ標準時)に対応します。- パラメータ:
date
- 1970年1月1日、0時0分0秒GMT (グリニッジ標準時)を起点とした時間をミリ秒で表した値で、8099年のミリ秒表現を超えない値。 負の値は、1970年1月1日、0時0分0秒GMT (グリニッジ標準時)より前のミリ秒を示す。
-
-
メソッドの詳細
-
setTime
public void setTime(long date) 指定されたミリ秒の値を使って、既存のDate
オブジェクトを設定します。 指定されたミリ秒の値に時間の情報が含まれている場合、ドライバは時間コンポーネントをデフォルトのタイムゾーン(アプリケーションを実行しているJava仮想マシンのタイムゾーン)の時間に設定します。この時間はゼロGMT (グリニッジ標準時)に対応します。 -
valueOf
JDBC日付エスケープ形式の文字列をDate
値に変換します。- パラメータ:
s
- 形式「yyyy-[m]m-[d]d」で日付を表すString
オブジェクト。mm
とdd
の先頭のゼロは省略できる。- 戻り値:
- 指定された日付を表す
java.sql.Date
オブジェクト - 例外:
IllegalArgumentException
- 指定された日付がJDBC日付エスケープ形式(yyyy-[m]m-[d]d)ではない場合
-
toString
public String toString()日付エスケープ形式yyyy-mm-ddに整形します。 -
getHours
@Deprecated(since="1.2") public int getHours()非推奨。このメソッドは非推奨です。SQL Date値は時間コンポーネントを持たないので、このメソッドは使わないでください。- オーバーライド:
getHours
、クラスDate
- 戻り値:
- この日付が表す時
- 例外:
IllegalArgumentException
- このメソッドが呼び出された場合- 関連項目:
-
getMinutes
@Deprecated(since="1.2") public int getMinutes()非推奨。このメソッドは非推奨です。SQL Date値は時間コンポーネントを持たないので、このメソッドは使わないでください。- オーバーライド:
getMinutes
、クラスDate
- 戻り値:
- この日付で表される時を過ぎた分数
- 例外:
IllegalArgumentException
- このメソッドが呼び出された場合- 関連項目:
-
getSeconds
@Deprecated(since="1.2") public int getSeconds()非推奨。このメソッドは非推奨です。SQL Date値は時間コンポーネントを持たないので、このメソッドは使わないでください。- オーバーライド:
getSeconds
、クラスDate
- 戻り値:
- この日付で表される、分を過ぎた秒数
- 例外:
IllegalArgumentException
- このメソッドが呼び出された場合- 関連項目:
-
setHours
@Deprecated(since="1.2") public void setHours(int i) 非推奨。このメソッドは非推奨です。SQL Date値は時間コンポーネントを持たないので、このメソッドは使わないでください。- オーバーライド:
setHours
、クラスDate
- パラメータ:
i
- 時間の値。- 例外:
IllegalArgumentException
- このメソッドが呼び出された場合- 関連項目:
-
setMinutes
@Deprecated(since="1.2") public void setMinutes(int i) 非推奨。このメソッドは非推奨です。SQL Date値は時間コンポーネントを持たないので、このメソッドは使わないでください。- オーバーライド:
setMinutes
、クラスDate
- パラメータ:
i
- 分の値。- 例外:
IllegalArgumentException
- このメソッドが呼び出された場合- 関連項目:
-
setSeconds
@Deprecated(since="1.2") public void setSeconds(int i) 非推奨。このメソッドは非推奨です。SQL Date値は時間コンポーネントを持たないので、このメソッドは使わないでください。- オーバーライド:
setSeconds
、クラスDate
- パラメータ:
i
- 秒の値。- 例外:
IllegalArgumentException
- このメソッドが呼び出された場合- 関連項目:
-
valueOf
指定されたLocalDate
と同じ年、月、および月間通算日の値を持つDate
のインスタンスをLocalDate
オブジェクトから取得します。指定された
LocalDate
は、ローカル・タイムゾーンのローカル日付として解釈されます。- パラメータ:
date
- 変換するLocalDate
- 戻り値:
Date
オブジェクト- 例外:
NullPointerException
-date
がnullの場合- 導入されたバージョン:
- 1.8
-
toLocalDate
public LocalDate toLocalDate()このDate
オブジェクトから年、月、日を使用してLocalDate
インスタンスを作成します。- 戻り値:
- 同じ日付値を表す
LocalDate
オブジェクト - 導入されたバージョン:
- 1.8
-
toInstant
public Instant toInstant()このメソッドは常にUnsupportedOperationExceptionをスローします。SQLDate
値は時間コンポーネントを持たないので、このメソッドは使わないでください。- オーバーライド:
toInstant
、クラスDate
- 戻り値:
- この
Date
オブジェクトと同じ時系列上の時点を表すインスタント - 例外:
UnsupportedOperationException
- このメソッドが呼び出された場合
-
Date(long date)
を使用します