当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

Time (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.sql
类 Time

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

所有已实现的接口：

Serializable, Cloneable, Comparable<Date>

---

public class Time
extends Date

一个与 java.util.Date 类有关的瘦包装器 (thin wrapper)，它允许 JDBC 将该类标识为 SQL TIME 值。Time 类添加格式化和解析操作以支持时间值的 JDBC 转义语法。

应该将日期组件设置为 1970 年 1 月 1 日的 "zero epoch" 值并且不应访问该值。

另请参见：

序列化表格

---

构造方法摘要
Time(int hour, int minute, int second)           已过时。 使用采用毫秒值的构造方法取代此构造方法
Time(long time)           使用毫秒时间值构造 Time 对象。

 

方法摘要
int	getDate()           已过时。
int	getDay()           已过时。
int	getMonth()           已过时。
int	getYear()           已过时。
void	setDate(int i)           已过时。
void	setMonth(int i)           已过时。
void	setTime(long time)           使用毫秒时间值设置 Time 对象。
void	setYear(int i)           已过时。
String	toString()           使用 JDBC 时间转义格式对时间进行格式化。
static Time	valueOf(String s)           将使用 JDBC 时间转义格式的字符串转换为 Time 值。

 

从类 java.util.Date 继承的方法
after, before, clone, compareTo, equals, getHours, getMinutes, getSeconds, getTime, getTimezoneOffset, hashCode, parse, setHours, setMinutes, setSeconds, toGMTString, toLocaleString, UTC

 

从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, wait, wait, wait

 

构造方法详细信息

Time

@Deprecated
public Time(int hour,
                       int minute,
                       int second)

已过时。 使用采用毫秒值的构造方法取代此构造方法

构造一个 Time 对象，用小时、分钟和秒钟的给定值对其进行初始化。驱动程序将日期组件设置为 1970 年 1 月 1 日。尝试访问 Time 对象的日期组件的任何方法都将抛出 java.lang.IllegalArgumentException。

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

参数：

hour - 0 到 23

minute - 0 到 59

second - 0 到 59

---

Time

public Time(long time)

使用毫秒时间值构造 Time 对象。

参数：

time - 自从 1970 年 1 月 1 日 00:00:00 GMT 以来的毫秒数；负数表示在 1970 年 1 月 1 日 00:00:00 GMT 之前的毫秒数

方法详细信息

setTime

public void setTime(long time)

使用毫秒时间值设置 Time 对象。

覆盖：

类 Date 中的 setTime

参数：

time - 自从 1970 年 1 月 1 日 00:00:00 GMT 以来的毫秒数；负数表示在 1970 年 1 月 1 日 00:00:00 GMT 之前的毫秒数

---

valueOf

public static Time valueOf(String s)

将使用 JDBC 时间转义格式的字符串转换为 Time 值。

参数：

s - 使用 "hh:mm:ss" 格式的时间

返回：

相应的 Time 对象

---

toString

public String toString()

使用 JDBC 时间转义格式对时间进行格式化。

覆盖：

类 Date 中的 toString

返回：

使用 hh:mm:ss 格式的 String

另请参见：

Date.toLocaleString(), Date.toGMTString()

---

getYear

@Deprecated
public int getYear()

已过时。 

此方法已不建议使用并且不应再使用，因为 SQL TIME 值没有年组件。

覆盖：

类 Date 中的 getYear

返回：

日期表示的年份减去 1900。

抛出：

IllegalArgumentException - 如果调用此方法

另请参见：

setYear(int)

---

getMonth

@Deprecated
public int getMonth()

已过时。 

此方法已废弃，不应再使用，因为 SQL TIME 值没有月 (month) 组件。

覆盖：

类 Date 中的 getMonth

返回：

此日期所表示的月份。

抛出：

IllegalArgumentException - 如果调用此方法

另请参见：

setMonth(int)

---

getDay

@Deprecated
public int getDay()

已过时。 

此方法已不建议使用并且不应再使用，因为 SQL TIME 值没有日 (day) 组件。

覆盖：

类 Date 中的 getDay

返回：

此日期所表示的一周中的某一天。

抛出：

IllegalArgumentException - 如果调用此方法

另请参见：

Calendar

---

getDate

@Deprecated
public int getDate()

已过时。 

此方法已不建议使用并且不应再使用，因为 SQL TIME 值没有日期 (date) 组件。

覆盖：

类 Date 中的 getDate

返回：

此日期所表示的月份中的某一天。

抛出：

IllegalArgumentException - 如果调用此方法

另请参见：

setDate(int)

---

setYear

@Deprecated
public void setYear(int i)

已过时。 

此方法已不建议使用并且不应再使用，因为 SQL TIME 值没有年 (year) 组件。

覆盖：

类 Date 中的 setYear

参数：

i - 年份值。

抛出：

IllegalArgumentException - 如果调用此方法

另请参见：

getYear()

---

setMonth

@Deprecated
public void setMonth(int i)

已过时。 

此方法已不建议使用并且不应再使用，因为 SQL TIME 值没有月 (month) 组件。

覆盖：

类 Date 中的 setMonth

参数：

i - 0-11 之间的月份值。

抛出：

IllegalArgumentException - 如果调用此方法

另请参见：

getMonth()

---

setDate

@Deprecated
public void setDate(int i)

已过时。 

此方法已不建议使用并且不应再使用，因为 SQL TIME 值没有日期 (date) 组件。

覆盖：

类 Date 中的 setDate

参数：

i - 月份中 1-31 之间的某一天。

抛出：

IllegalArgumentException - 如果调用此方法

另请参见：

getDate()

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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

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