compact2, compact3

java.sql

Class Date

java.lang.Object

java.util.Date

java.sql.Date

All Implemented Interfaces:

Serializable ， Cloneable ， Comparable < Date >

public class Date
extends Date

一个大约一毫秒值的薄包装，允许JDBC将其标识为SQL DATE值。 毫秒值表示1970年1月1日00：00：00.000 GMT之后的毫秒数。

为了符合SQL DATE ，由java.sql.Date实例包装的毫秒值必须通过在实例关联的特定时区中将小时，分钟，秒和毫秒设置为零来“归一化”。

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
Date(int year, int month, int day) 已弃用 而是使用构造Date(long date)
Date(long date) 使用给定的毫秒时间值构造一个 Date对象。

方法摘要

Modifier and Type	Method and Description
int	getHours() 已弃用
int	getMinutes() 已弃用
int	getSeconds() 已弃用
void	setHours(int i) 已弃用
void	setMinutes(int i) 已弃用
void	setSeconds(int i) 已弃用
void	setTime(long date) 使用给定的毫秒时间值设置现有的 Date对象。
Instant	toInstant() 此方法总是引发UnsupportedOperationException，因为SQL Date值没有时间组件，所以不应该使用。
LocalDate	toLocalDate() 将此 Date对象转换为 LocalDate
String	toString() 格式化日期转义格式yyyy-mm-dd。
static Date	valueOf(LocalDate date) 从一个LocalDate对象获取一个Date的实例，具有与给定的LocalDate相同的年，月和日的月值。
static Date	valueOf(String s) 将JDBC日期转义格式的字符串转换为 Date值。

Methods inherited from class java.util.Date

after, before, clone, compareTo, equals, from, getDate, getDay, getMonth, getTime, getTimezoneOffset, getYear, hashCode, parse, setDate, setMonth, setYear, toGMTString, toLocaleString, UTC

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

构造方法详细信息

Date

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

已弃用 而是使用构造Date(long date)

构造一个以给定的年，月和日初始化的Date对象。

如果给定的参数超出界限，结果是未定义的。

参数

year - 年减1900; 必须是0到8099.（注意8099是9999减1900。）

month - 0至11

day - 1至31

Date

public Date(long date)

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

参数

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

方法详细信息

setTime

public void setTime(long date)

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

重写：

setTime在 Date

参数

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

valueOf

public static Date valueOf(String s)

将JDBC日期转义格式的字符串转换为 Date值。

参数

s - 以“yyyy- [m] m- [d] d”格式表示日期的String对象。 mm和dd的前导零也可以省略。

结果

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

异常

IllegalArgumentException - 如果给定的日期不在JDBC日期转义格式（yyyy- [m] m- [d] d）

toString

public String toString()

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

重写：

toString在 Date

结果

一个以yyyy-mm-dd格式的字符串

另请参见：

Date.toLocaleString() ， Date.toGMTString()

getHours

@Deprecated
public int getHours()

已弃用

此方法已被弃用，不应使用，因为SQL日期值没有时间组件。

重写：

getHours在 Date

结果

这个日期代表的时间。

异常

IllegalArgumentException - 如果这个方法被调用

另请参见：

setHours(int)

getMinutes

@Deprecated
public int getMinutes()

已弃用

此方法已被弃用，不应使用，因为SQL日期值没有时间组件。

重写：

getMinutes在 Date

结果

由该日期表示的小时数。

异常

IllegalArgumentException - 如果这个方法被调用

另请参见：

setMinutes(int)

getSeconds

@Deprecated
public int getSeconds()

已弃用

此方法已被弃用，不应使用，因为SQL日期值没有时间组件。

重写：

getSeconds在类 Date

结果

由此日期表示的分钟秒数。

异常

IllegalArgumentException - 如果这个方法被调用

另请参见：

setSeconds(int)

setHours

@Deprecated
public void setHours(int i)

已弃用

此方法已被弃用，不应使用，因为SQL日期值没有时间组件。

重写：

setHours在 Date

参数

i - 小时值。

异常

IllegalArgumentException - 如果这个方法被调用

另请参见：

getHours()

setMinutes

@Deprecated
public void setMinutes(int i)

已弃用

此方法已被弃用，不应使用，因为SQL日期值没有时间组件。

重写：

setMinutes在 Date

参数

i - 分钟的值。

异常

IllegalArgumentException - 如果这个方法被调用

另请参见：

getMinutes()

setSeconds

@Deprecated
public void setSeconds(int i)

已弃用

此方法已被弃用，不应使用，因为SQL日期值没有时间组件。

重写：

setSeconds在 Date

参数

i - 秒值。

异常

IllegalArgumentException - 如果调用此方法

另请参见：

getSeconds()

valueOf

public static Date valueOf(LocalDate date)

获取的实例Date从LocalDate用相同的年份，月份和月份中日作为给定对象LocalDate 。

提供的LocalDate被解释为本地时区的本地日期。

参数

date - a LocalDate转换

结果

一个 Date对象

异常

NullPointerException - 如果 date为空

从以下版本开始：

1.8

toLocalDate

public LocalDate toLocalDate()

将此Date对象转换为LocalDate

该转换创建一个LocalDate ，表示与本地时区的Date相同的日期值

结果

一个 LocalDate相同日期值的 LocalDate对象

从以下版本开始：

1.8

toInstant

public Instant toInstant()

此方法总是引发UnsupportedOperationException，因为SQL Date值没有时间组件，所以不应该使用它。

重写：

toInstant在 Date

结果

即时表示与这个 Date对象在时间线上相同的点

异常

UnsupportedOperationException - 如果调用此方法