Module  java.sql
软件包  java.sql

Class Date

  • All Implemented Interfaces:
    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
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • 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对象。 如果给定的毫秒值包含时间信息，则驱动程序将将时间组件设置为对应于零GMT的默认时区（运行应用程序的Java虚拟机的时区）。
        参数
        date - 1970年1月1日以来的毫秒数，00:00:00 GMT不超过8099年的毫秒表示。负数表示1970年1月1日00:00:00 GMT之前的毫秒数。

    • 方法详细信息

      • 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）

      • valueOf

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

        提供的LocalDate被解释为本地时区的本地日期。

        参数
        date - a转换 LocalDate
        结果
        一个 Date对象
        异常
        NullPointerException - 如果 date为空
        从以下版本开始：
        1.8

      • toLocalDate

        public LocalDate toLocalDate​()
        使用这个 Date对象的年，月和日创建一个 LocalDate实例。
        结果
        表示相同日期值的 LocalDate对象
        从以下版本开始：
        1.8

      • toInstant

        public Instant toInstant​()
        此方法总是引发UnsupportedOperationException，因为SQL Date值没有时间组件，因此不应该使用此方法。
        重写：
        toInstant在类 Date
        结果
        表示与 Date对象在时间线上相同点的瞬间
        异常
        UnsupportedOperationException - if this method is invoked