Java java.sql 类 Date（JDK5）

所有类

java.sql
类 Date

java.lang.Object
  java.util.Date
      java.sql.Date

所有已实现的接口：

Serializable, Cloneable, Comparable<Date>

public class Date
   
   
   
   
   
extends Date
   
   
   
   
   

一个包装了毫秒值的瘦包装器 (thin wrapper)，它允许 JDBC 将毫秒值标识为 SQL DATE 值。毫秒值表示自 1970 年 1 月 1 日 00:00:00 GMT 以来经过的毫秒数。

为了与 SQL DATE 的定义一致，由 java.sql.Date 实例包装的毫秒值必须通过将时间、分钟、秒和毫秒设置为与该实例相关的特定时区中的零来“规范化”。

另请参见：

序列化表格

Date

@Deprecated
public Date(int year,
                       int month,
                       int day)

已过时。 使用构造方法 Date(long date) 替代

构造一个使用给定 year、month 和 daya 初始化的 Date 对象。

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

参数：

year - year 减去 1900，它必须是 0 到 8099 之间的数。（注意，8099 是由 9999 减去 1900 得到的。）

month - 0 到 11 之间的数

day - 1 到 31 之间的数

Date

public Date(long date)

使用给定毫秒时间值构造一个 Date 对象。如果给定毫秒值包含时间信息，则驱动程序会将时间组件设置为对应于零 GMT 的默认时区（运行应用程序的 Java 虚拟机的时区）中的时间。

参数：

date - 不超过 year 8099 的毫秒表示的自 1970 年 1 月 1 日 00:00:00 GMT 以来的毫秒数。负数指示在 1970 年 1 月 1 日 00:00:00 GMT 之前的毫秒数。

setTime

public void setTime(long date)

使用给定毫秒时间值设置现有 Date 对象。如果给定毫秒值包含时间信息，则驱动程序会将时间组件设置为对应于零 GMT 的默认时区（运行应用程序的 Java 虚拟机的时区）中的时间。

覆盖：

类 Date 中的 setTime

参数：

date - 不超过 year 8099 的毫秒表示的自 1970 年 1 月 1 日 00:00:00 GMT 以来的毫秒数。。负数指示在 1970 年 1 月 1 日 00:00:00 GMT 之前的毫秒数。

valueOf

public static Date valueOf(String s)

将 JDBC 日期转义形式的字符串转换成 Date 值。

参数：

s - 表示 "yyyy-mm-dd" 形式的日期的 String 对象

返回：

表示给定日期的 java.sql.Date 对象

抛出：

IllegalArgumentException - 如果给定日期不是 JDBC 日期转义形式 (yyyy-mm-dd)

toString

public String toString()

格式化日期转义形式 yyyy-mm-dd 的日期。

注：要为 SimpleDateFormat 类指定一个日期格式，可以使用 "yyyy.MM.dd" 格式，而不是使用 "yyyy-mm-dd" 格式。在 SimpleDateFormat 的上下文中，"mm" 表示分钟，而不是表示月份。例如：

  格式模式                                结果
  --------------                         -------
        "yyyy.MM.dd G 'at' hh:mm:ss z"    ->>  1996.07.10 AD at 15:08:56 PDT
 

覆盖：

类 Date 中的 toString

返回：

一个 yyyy-mm-dd 形式的 String

另请参见：

Date.toLocaleString(), Date.toGMTString()

getHours

@Deprecated
public int getHours()

已过时。 

因为 SQL Date 值没有时间组件，所以不建议并且不应使用此方法。

覆盖：

类 Date 中的 getHours

返回：

此日期所表示的小时。

抛出：

IllegalArgumentException - 如果调用此方法

另请参见：

setHours(int)

getMinutes

@Deprecated
public int getMinutes()

已过时。 

因为 SQL Date 值没有时间组件，所以不建议并且不应使用此方法。

覆盖：

类 Date 中的 getMinutes

返回：

此日期所表示的小时已经过去的分钟数。

抛出：

IllegalArgumentException - 如果调用此方法

另请参见：

setMinutes(int)

getSeconds

@Deprecated
public int getSeconds()

已过时。 

因为 SQL Date 值没有时间组件，所以不建议并且不应使用此方法。

覆盖：

类 Date 中的 getSeconds

返回：

此日期表示的分钟已经过去的秒数。

抛出：

IllegalArgumentException - 如果调用此方法

另请参见：

setSeconds(int)