Java java.sql 类 Timestamp（JDK5）

所有类

java.sql
类 Timestamp

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

所有已实现的接口：

Serializable, Cloneable, Comparable<Date>

public class Timestamp
   
   
   
   
   
extends Date
   
   
   
   
   

一个与 java.util.Date 类有关的瘦包装器 (thin wrapper)，它允许 JDBC API 将该类标识为 SQL TIMESTAMP 值。它添加保存 SQL TIMESTAMP 毫微秒值和提供支持时间戳值的 JDBC 转义语法的格式化和解析操作的能力。

注：此类型由 java.util.Date 和单独的毫微秒值组成。只有整数秒才会存储在 java.util.Date 组件中。小数秒（毫微秒）是独立存在的。传递 java.util.Date 类型的值时，Timestamp.equals(Object) 方法永远不会返回 true，因为日期的毫微秒组件是未知的。因此，相对于 java.util.Date.equals(Object) 方法而言，Timestamp.equals(Object) 方法是不对称的。此外，hashcode 方法使用基础 java.util.Date 实现并因此在其计算中不包括毫微秒。

鉴于 Timestamp 类和上述 java.util.Date 类之间的不同，建议代码一般不要将 Timestamp 值视为 java.util.Date 的实例。Timestamp 和 java.util.Date 之间的继承关系实际上指的是实现继承，而不是类型继承。

另请参见：

序列化表格

Timestamp

@Deprecated
public Timestamp(int year,
                            int month,
                            int date,
                            int hour,
                            int minute,
                            int second,
                            int nano)

已过时。 使用构造方法 Timestamp(long millis) 来代替

构造一个 Timestamp 对象，使用给定值对其进行初始化。

参数：

year - 年减去 1900

month - 0 到 11

date - 1 到 31

hour - 0 到 23

minute - 0 到 59

second - 0 到 59

nano - 0 到 999,999,999

抛出：

IllegalArgumentException - 如果毫微参数超出范围

Timestamp

public Timestamp(long time)

使用毫秒时间值构造 Timestamp 对象。整数秒存储在基础日期值中；小数秒存储在 Timestamp 对象的 nanos 字段中。

参数：

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

另请参见：

for more information

setTime

public void setTime(long time)

设置此 Timestamp 对象，以表示 1970 年 1 月 1 日 00:00:00 GMT 以后 time 毫秒的时间点。

覆盖：

类 Date 中的 setTime

参数：

time - 毫秒数。

另请参见：

getTime(), Timestamp(long time), for more information

getTime

public long getTime()

返回此 Timestamp 对象表示的自 1970 年 1 月 1 日 00:00:00 GMT 以来的毫秒数。

覆盖：

类 Date 中的 getTime

返回：

此日期表示的自 1970 年 1 月 1 日 00:00:00 GMT 以来的毫秒数。

另请参见：

setTime(long)

valueOf

public static Timestamp valueOf(String s)

将使用 JDBC 时间戳转义格式的 String 对象转换为 Timestamp 值。

参数：

s - 使用 yyyy-mm-dd hh:mm:ss.fffffffff 格式的时间戳

返回：

相应的 Timestamp 值

抛出：

IllegalArgumentException - 如果给定的参数不具有 yyyy-mm-dd hh:mm:ss.fffffffff 格式

toString

public String toString()

使用 JDBC 时间戳转义格式编排时间戳。yyyy-mm-dd hh:mm:ss.fffffffff，其中 ffffffffff 指示毫微秒。

注：要指定 java.text.SimpleDateFormat 类的时间戳，请使用 "yyyy.MM.dd" 而不要使用 "yyyy-mm-dd"。在 java.text.SimpleDateFormat 的上下文中，"mm" 指示分钟而不是月。注意，java.text.SimpleDateFormat 不允许使用 Timestamp 对象的毫微秒组件。例如：

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

 

覆盖：

类 Date 中的 toString

返回：

使用 yyyy-mm-dd hh:mm:ss.fffffffff 格式的 String 对象

另请参见：

Date.toLocaleString(), Date.toGMTString()

getNanos

public int getNanos()

获取此 Timestamp 对象的 nanos 值。

返回：

此 Timestamp 对象的小数秒组件

另请参见：

setNanos(int)

setNanos

public void setNanos(int n)

将此 Timestamp 对象的 nanos 字段设置为给定值。

参数：

n - 新小数秒组件

抛出：

IllegalArgumentException - 如果给定参数大于 999999999 或小于 0

另请参见：

getNanos()