JavaTM 2 Platform
Std. Ed. v1.3

java.sql
クラス Date

java.lang.Object
  |
  +--java.util.Date
        |
        +--java.sql.Date
すべての実装インタフェース:
Cloneable, Comparable, Serializable

public class Date
extends Date

ミリ秒の値をラップする thin ラッパーであり、これによって JDBC がミリ秒の値を SQL DATE として扱うことができるようになります。ミリ秒の値は、1970 年 1 月 1 日グリニッジ標準時 00:00:00.000 からの経過時間をミリ秒で表した数値です。

SQL DATE の定義に対応させるために、java.sql.Date のインスタンスでラップされたミリ秒の値は、インスタンスが関連した特定のタイムゾーンで時間、分、秒、ミリ秒をゼロに設定することで、「標準化」する必要があります。

関連項目:
直列化された形式

コンストラクタの概要
Date(int year, int month, int day)
          推奨されていません。 代わりにコンストラクタ Date(long date) を使用してください。
Date(long date)
          ミリ秒の値を使って、Date オブジェクトを構築します。
 
メソッドの概要
 int getHours()
          推奨されていません。  
 int getMinutes()
          推奨されていません。  
 int getSeconds()
          推奨されていません。  
 void setHours(int i)
          推奨されていません。  
 void setMinutes(int i)
          推奨されていません。  
 void setSeconds(int i)
          推奨されていません。  
 void setTime(long date)
          指定されたミリ秒の値を使って、既存の Date オブジェクトを設定します。
 String toString()
          日付エスケープ形式 yyyy-mm-dd の日付を変換します。
static Date valueOf(String s)
          JDBC 日付エスケープ形式中の文字列を Date 値に変換します。
 
クラス java.util.Date から継承したメソッド
after, before, clone, compareTo, compareTo, equals, getDate, getDay, getMonth, getTime, getTimezoneOffset, getYear, hashCode, parse, setDate, setMonth, setYear, toGMTString, toLocaleString, UTC
 
クラス java.lang.Object から継承したメソッド
finalize, getClass, notify, notifyAll, wait, wait, wait
 

コンストラクタの詳細

Date

public Date(int year,
            int month,
            int day)
推奨されていません。 代わりにコンストラクタ Date(long date) を使用してください。

指定された年、月、日で初期化された Date オブジェクトを構築します。
パラメータ:
year - 年数 - 1900 (年数から 1900 を引いた値)
month - 0 〜 11
day - 1 〜 31

Date

public Date(long date)
ミリ秒の値を使って、Date オブジェクトを構築します。指定されたミリ秒の値に時間の情報が含まれている場合、ドライバは時間コンポーネントを 0 に設定します。
パラメータ:
date - 1970 年 1 月 1 日、0 時 0 分 0 秒 GMT (グリニッジ標準時) を起点とした時間をミリ秒で表した値。負の値は、1970 年 1 月 1 日、0 時 0 分 0 秒 GMT (グリニッジ標準時) より前のミリ秒を示す
メソッドの詳細

setTime

public void setTime(long date)
指定されたミリ秒の値を使って、既存の Date オブジェクトを設定します。指定されたミリ秒の値に時間の情報が含まれている場合、ドライバは時間コンポーネントを 0 に設定します。
オーバーライド:
クラス Date 内の setTime
パラメータ:
date - 1970 年 1 月 1 日、0 時 0 分 0 秒 GMT (グリニッジ標準時) を起点とした時間をミリ秒で表した値。負の値は、1970 年 1 月 1 日、0 時 0 分 0 秒 GMT (グリニッジ標準時) より前のミリ秒を示す

valueOf

public static Date valueOf(String s)
JDBC 日付エスケープ形式中の文字列を Date 値に変換します。
パラメータ:
s - "yyyy-mm-dd" 形式の日付
戻り値:
指定された日付を表す Date オブジェクト

toString

public String toString()
日付エスケープ形式 yyyy-mm-dd の日付を変換します。

注: クラス SimpleDateFormat の日付形式を指定するためには、「yyyy-mm-dd」ではなく「yyyy.MM.dd」を使用します。SimpleDateFormat のコンテキストでは、「mm」は月ではなく分を表しています。例を示します。


  フォーマットパターン                   結果
  --------------                         -------
	"yyyy.MM.dd G 'at' hh:mm:ss z"    ->>  1996.07.10 AD at 15:08:56 PDT
オーバーライド:
クラス Date 内の toString
戻り値:
yyyy-mm-dd 形式の文字列

getHours

public int getHours()
推奨されていません。  

このメソッドは推奨されていません。SQL Date 値は時間コンポーネントを持たないので、このメソッドは使わないでください。
オーバーライド:
クラス Date 内の getHours
例外:
IllegalArgumentException - このメソッドが呼び出された場合

getMinutes

public int getMinutes()
推奨されていません。  

このメソッドは推奨されていません。SQL Date 値は時間コンポーネントを持たないので、このメソッドは使わないでください。
オーバーライド:
クラス Date 内の getMinutes
例外:
IllegalArgumentException - このメソッドが呼び出された場合

getSeconds

public int getSeconds()
推奨されていません。  

このメソッドは推奨されていません。SQL Date 値は時間コンポーネントを持たないので、このメソッドは使わないでください。
オーバーライド:
クラス Date 内の getSeconds
例外:
IllegalArgumentException - このメソッドが呼び出された場合

setHours

public void setHours(int i)
推奨されていません。  

このメソッドは推奨されていません。SQL Date 値は時間コンポーネントを持たないので、このメソッドは使わないでください。
オーバーライド:
クラス Date 内の setHours
例外:
IllegalArgumentException - このメソッドが呼び出された場合

setMinutes

public void setMinutes(int i)
推奨されていません。  

このメソッドは推奨されていません。SQL Date 値は時間コンポーネントを持たないので、このメソッドは使わないでください。
オーバーライド:
クラス Date 内の setMinutes
例外:
IllegalArgumentException - このメソッドが呼び出された場合

setSeconds

public void setSeconds(int i)
推奨されていません。  

このメソッドは推奨されていません。SQL Date 値は時間コンポーネントを持たないので、このメソッドは使わないでください。
オーバーライド:
クラス Date 内の setSeconds
例外:
IllegalArgumentException - このメソッドが呼び出された場合

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.