Module java.sql
Package java.sql

Class Date

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 GMT以来经过的毫秒数。

为符合SQL DATE的定义，由java.sql.Date实例包装的毫秒值必须通过在实例关联的特定时区中将小时、分钟、秒和毫秒设置为零来进行“标准化”。

自:
1.1
参见:

  • Constructor Details

    • Date

      @Deprecated(since="1.2") public Date(int year, int month, int day)
      Deprecated.
      instead use the constructor Date(long date)
      使用给定的年、月和日构造一个初始化的Date对象。

      如果给定的参数超出范围，则结果是未定义的。

      参数:
      year - 年份减去1900；必须为0到8099。（请注意，8099是9999减去1900。）
      month - 0到11
      day - 1到31

    • Date

      public Date(long date)
      使用给定的毫秒时间值构造一个Date对象。如果给定的毫秒值包含时间信息，驱动程序将把时间组件设置为对应于零GMT的默认时区中的时间（运行应用程序的Java虚拟机的时区）。
      参数:
      date - 自1970年1月1日00:00:00 GMT以来的毫秒数，不得超过8099年的毫秒表示。负数表示1970年1月1日00:00:00 GMT之前的毫秒数。

  • Method Details

    • setTime

      public void setTime(long date)
      使用给定的毫秒时间值设置现有的Date对象。如果给定的毫秒值包含时间信息，驱动程序将把时间组件设置为对应于零GMT的默认时区中的时间（运行应用程序的Java虚拟机的时区）。
      覆盖:
      setTime 在类 Date中
      参数:
      date - 自1970年1月1日00:00:00 GMT以来的毫秒数，不得超过8099年的毫秒表示。负数表示1970年1月1日00:00:00 GMT之前的毫秒数。

    • valueOf

      public static Date valueOf(String s)
      将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格式化日期。
      覆盖:
      toString 在类 Date中
      返回:
      以yyyy-mm-dd格式的字符串
      参见:

    • getHours

      @Deprecated(since="1.2") public int getHours()
      Deprecated.
      此方法已弃用，不应使用，因为SQL日期值不具有时间组件。
      覆盖:
      getHours 在类 Date中
      返回:
      此日期表示的小时。
      抛出:
      IllegalArgumentException - 如果调用此方法
      参见:

    • getMinutes

      @Deprecated(since="1.2") public int getMinutes()
      Deprecated.
      此方法已弃用，不应使用，因为SQL日期值不具有时间组件。
      覆盖:
      getMinutes 在类 Date中
      返回:
      此日期表示的小时后的分钟数。
      抛出:
      IllegalArgumentException - 如果调用此方法
      参见:

    • getSeconds

      @Deprecated(since="1.2") public int getSeconds()
      Deprecated.
      此方法已弃用，不应使用，因为SQL日期值不具有时间组件。
      覆盖:
      getSeconds 在类 Date中
      返回:
      此日期表示的分钟后的秒数。
      抛出:
      IllegalArgumentException - 如果调用此方法
      参见:

    • setHours

      @Deprecated(since="1.2") public void setHours(int i)
      Deprecated.
      此方法已弃用，不应使用，因为SQL日期值不具有时间组件。
      覆盖:
      setHours 在类 Date中
      参数:
      i - 小时值。
      抛出:
      IllegalArgumentException - 如果调用此方法
      参见:

    • setMinutes

      @Deprecated(since="1.2") public void setMinutes(int i)
      Deprecated.
      此方法已弃用，不应使用，因为SQL日期值不具有时间组件。
      覆盖:
      setMinutes 在类 Date中
      参数:
      i - 分钟值。
      抛出:
      IllegalArgumentException - 如果调用此方法
      参见:

    • setSeconds

      @Deprecated(since="1.2") public void setSeconds(int i)
      Deprecated.
      此方法已弃用，不应使用，因为SQL日期值不具有时间组件。
      覆盖:
      setSeconds 在类 Date中
      参数:
      i - 秒值。
      抛出:
      IllegalArgumentException - 如果调用此方法
      参见:

    • valueOf

      public static Date valueOf(LocalDate date)
      从具有与给定LocalDate相同年、月和日值的LocalDate对象获取Date的实例。

      提供的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 - 如果调用此方法