JavaTM 2 Platform
Standard Ed. 5.0

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(int year, int month, int day)
          已过时。 使用构造方法 Date(long date) 替代
Date(long date)
          使用给定毫秒时间值构造一个 Date 对象。
 
方法摘要
 int getHours()
          已过时。  
 int getMinutes()
          已过时。  
 int getSeconds()
          已过时。  
 void setHours(int i)
          已过时。  
 void setMinutes(int i)
          已过时。  
 void setSeconds(int i)
          已过时。  
 void setTime(long date)
          使用给定毫秒时间值设置现有 Date 对象。
 String toString()
          格式化日期转义形式 yyyy-mm-dd 的日期。
static Date valueOf(String s)
          将 JDBC 日期转义形式的字符串转换成 Date 值。
 
从类 java.util.Date 继承的方法
after, before, clone, compareTo, equals, getDate, getDay, getMonth, getTime, getTimezoneOffset, getYear, hashCode, parse, setDate, setMonth, setYear, toGMTString, toLocaleString, UTC
 
从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

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)

setHours

@Deprecated
public void setHours(int i)
已过时。 

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

覆盖:
Date 中的 setHours
参数:
i - 小时值。
抛出:
IllegalArgumentException - 如果调用此方法
另请参见:
getHours()

setMinutes

@Deprecated
public void setMinutes(int i)
已过时。 

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

覆盖:
Date 中的 setMinutes
参数:
i - 分钟值。
抛出:
IllegalArgumentException - 如果调用此方法
另请参见:
getMinutes()

setSeconds

@Deprecated
public void setSeconds(int i)
已过时。 

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

覆盖:
Date 中的 setSeconds
参数:
i - 秒数值。
抛出:
IllegalArgumentException - 如果调用此方法
另请参见:
getSeconds()

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策