为什么阿里Java开发手册不推荐使用Timestamp

开发手册

不推荐用java.sql.Date、java.sql.Time网上说的文章有很多。

参考文章：一文告诉你Java日期时间API到底有多烂

但为什么不推荐使用java.sql.Timestamp文章比较少。

原因

Oracle官网文档中这么写：

可以看到，根源是因为java.sql.Timestamp父类java.sql.Date的fastTime属性存储秒，而java.sql.Timestamp的nanos存储秒以外的毫秒。所以秒和毫秒是分别存储的，从Timestamp的构造方法也可以看出来：

public Timestamp(long time) {
	// 设置java.sql.Date的fastTime
	super((time/1000)*1000);
	// 设置java.sql.Timestamp的nanos

	if (nanos < 0) {
		nanos = 1000000000 + nanos;
		super.setTime(((time/1000)-1)*1000);
	}
}

所以会有什么问题呢？

1. equals的问题

The Timestamp.equals(Object) method never returns true when passed an object that isn't an instance of java.sql.Timestamp, because the nanos component of a date is unknown.

可能程序员会想，我两个时间都是从一个millis中创建的，那时间应该是一样的。但是因为Timestamp的设计，它们的值不相等。

1. after的问题

期待的答案应该是false。

原因是：

    public boolean after(Date when) {
        return getMillisOf(this) > getMillisOf(when);
    }

    static final long getMillisOf(Date date) {
        if (date.cdate == null || date.cdate.isNormalized()) {
            return date.fastTime;
        }
        BaseCalendar.Date d = (BaseCalendar.Date) date.cdate.clone();
        return gcal.getTime(d);
    }

date对象的fastTime值为：     1664429777371
timestamp对象的fastTime值为：1664429777000

看一下Timestamp的构造方法：

public Timestamp(long time) {
	// 设置java.sql.Date的fastTime
	super((time/1000)*1000);
	// 设置java.sql.Timestamp的nanos

	if (nanos < 0) {
		nanos = 1000000000 + nanos;
		super.setTime(((time/1000)-1)*1000);
	}
}

可以知道timestamp对象的fastTime的后三位为0。

而看Date的构造方法：

    public Date(long date) {
        fastTime = date;
    }

它是直接把传入的值赋值给fastTime。

总结

不将java.sql.Timestamp和其它java.util.Date的对象比较。