クラス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
関連項目:
  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    Date(int year, int month, int day)
    非推奨。
    かわりにコンストラクタDate(long date)を使用
    Date(long date)
    指定されたミリ秒の値を使ってDateオブジェクトを構築します。
  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    int
    非推奨。 
    int
    非推奨。 
    int
    非推奨。 
    void
    setHours(int i)
    非推奨。 
    void
    setMinutes(int i)
    非推奨。 
    void
    setSeconds(int i)
    非推奨。 
    void
    setTime(long date)
    指定されたミリ秒の値を使って、既存のDateオブジェクトを設定します。
    このメソッドは常にUnsupportedOperationExceptionをスローします。SQL Date値は時間コンポーネントを持たないので、このメソッドは使わないでください。
    このDateオブジェクトの年、月および日を使用して、LocalDateインスタンスを作成します。
    日付エスケープ形式yyyy-mm-ddに整形します。
    static Date
    JDBC日付エスケープ形式の文字列をDate値に変換します。
    static Date
    指定されたLocalDateと同じ年、月、および月間通算日の値を持つDateのインスタンスをLocalDateオブジェクトから取得します。

    クラス Dateで宣言されたメソッド

    after, before, clone, compareTo, equals, from, getDate, getDay, getMonth, getTime, getTimezoneOffset, getYear, hashCode, parse, setDate, setMonth, setYear, toGMTString, toLocaleString, UTC
    修飾子と型
    メソッド
    説明
    boolean
    after(Date when)
    この日付が、指定された日付より後にあるかどうかを判定します。
    boolean
    before(Date when)
    この日付が、指定された日付より前にあるかどうかを判定します。
    このオブジェクトのコピーを返します。
    int
    compareTo(Date anotherDate)
    順序付けのために2つのDateを比較します。
    boolean
    2つの日付が等しいかどうかを比較します。
    static Date
    from(Instant instant)
    InstantオブジェクトからDateのインスタンスを取得します。
    int
    非推奨。
    JDKバージョン1.1で、Calendar.get(Calendar.DAY_OF_MONTH)に置き換えられています。
    int
    非推奨。
    JDKバージョン1.1で、Calendar.get(Calendar.DAY_OF_WEEK)に置き換えられています。
    int
    非推奨。
    JDKバージョン1.1で、Calendar.get(Calendar.MONTH)に置き換えられています。
    long
    このDateオブジェクトで表される、1970年1月1日00:00:00 GMTからのミリ秒数を返します。
    int
    非推奨。
    JDKバージョン1.1で、-(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000)に置き換えられています。
    int
    非推奨。
    JDKバージョン1.1で、Calendar.get(Calendar.YEAR) - 1900に置き換えられています。
    int
    このオブジェクトに対するハッシュ・コード値を返します。
    static long
    非推奨。
    JDK version 1.1以降は、DateFormat.parse(String s)に置き換えられています。
    void
    setDate(int date)
    非推奨。
    JDKバージョン1.1で、Calendar.set(Calendar.DAY_OF_MONTH, int date)に置き換えられています。
    void
    setMonth(int month)
    非推奨。
    JDKバージョン1.1で、Calendar.set(Calendar.MONTH, int month)に置き換えられています。
    void
    setYear(int year)
    非推奨。
    JDKバージョン1.1で、Calendar.set(Calendar.YEAR, year + 1900)に置き換えられています。
    非推奨。
    JDKバージョン1.1で、GMT TimeZoneを使用してDateFormat.format(Date date)に置き換えられています。
    非推奨。
    JDKバージョン1.1で、DateFormat.format(Date date)に置き換えられています。
    static long
    UTC(int year, int month, int date, int hrs, int min, int sec)
    非推奨。
    JDKバージョン1.1で、UTC TimeZoneCalendar.getTime().getTime()を使用して、Calendar.set(year + 1900, month, date, hrs, min, sec)またはGregorianCalendar(year + 1900, month, date, hrs, min, sec)に置き換えられました。

    クラスオブジェクトで宣言されたメソッド

    finalize, getClass, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected void
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    このObjectの実行時クラスを返します。
    final void
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
  • コンストラクタの詳細

    • 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 - 11
      day - 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 (グリニッジ標準時)に対応します。
      オーバーライド:
      setTime、クラスDate
      パラメータ:
      date - 1970年1月1日、0時0分0秒GMT (グリニッジ標準時)を起点とした時間をミリ秒で表した値で、8099年のミリ秒表現を超えない値。 負の値は、1970年1月1日、0時0分0秒GMT (グリニッジ標準時)より前のミリ秒を示す。
    • valueOf

      public static Date valueOf(String s)
      JDBC日付エスケープ形式の文字列をDate値に変換します。
      パラメータ:
      s - 形式「yyyy-[m]m-[d]d」で日付を表すStringオブジェクト。 mmddの先頭のゼロは省略できる。
      戻り値:
      指定された日付を表すjava.sql.Dateオブジェクト
      スロー:
      IllegalArgumentException - 指定された日付がJDBC日付エスケープ形式(yyyy-[m]m-[d]d)ではない場合
    • toString

      public String toString()
      日付エスケープ形式yyyy-mm-ddに整形します。
      オーバーライド:
      toString、クラスDate
      戻り値:
      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

      public static Date valueOf(LocalDate date)
      指定された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をスローします。SQL Date値は時間コンポーネントを持たないので、このメソッドは使わないでください。
      オーバーライド:
      toInstant、クラスDate
      戻り値:
      このDateオブジェクトと同じ時系列上の時点を表すインスタント
      スロー:
      UnsupportedOperationException - このメソッドが呼び出された場合