模块  java.sql
软件包  java.sql

Class Date

  • 实现的所有接口
    SerializableCloneableComparable<Date>

    public class Dateextends 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对象。 mmdd的前导零也可以省略。
        结果
        表示给定日期的 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 - 如果调用此方法