Date

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 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
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()