模块  java.sql
软件包  java.sql

Class 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实例DATE的毫秒值必须通过在与实例关联的特定时区中将小时，分钟，秒和毫秒设置为零来“标准化”。

    从以下版本开始：
    1.1
    另请参见：
    Serialized Form

    • 构造方法详细信息

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

    • 方法详细信息

      • setTime

        public void setTime​(long date)
        使用给定的毫秒时间值设置现有的Date对象。 如果给定的毫秒值包含时间信息，则驱动程序将时间组件设置为默认时区（运行应用程序的Java虚拟机的时区）中与零GMT对应的时间。
        重写：
        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）

      • setHours

        @Deprecated(since="1.2")
public void setHours​(int i)
        Deprecated.
        不推荐使用此方法，因为SQL Date值没有时间组件，所以不应使用此方法。
        重写：
        setHours在类 Date
        参数
        i - 小时值。
        异常
        IllegalArgumentException - 如果调用此方法
        另请参见：
        getHours()

      • valueOf

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

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

        参数
        date - 要转换的 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 - 如果调用此方法