Name: acR10002 Date: 08/07/2001



This issue has been initially raised in 4410126 (see bug evaluation) but
is still not completely resolved. The allowed limits for input parameters
for the following methods:

java.sql.Timestamp.Timestamp(long time)
java.sql.Timestamp.setTime(long time)

are still underspecifyed. This has been partially fixed in 4477431 so the
upper limit has been documented. However, lower limit for time parameter
is still absent in the spec:

-------- javadoc Timestamp(long time)/setTime(long time), jdk1.4-b74 ---
 time - milliseconds since January 1, 1970, 00:00:00 GMT, not to exceed the
         number of milliseconds that represent the year 8099. A negative number
         is the number of milliseconds before January 1, 1970, 00:00:00 GMT.
-------------------------------------------------------------------------------------
So there is still no bound for a negative number. As a result, the
following example would produce different output in jdk1.4 and jdk1.3:

---------------- Test.java ----------------
import java.sql.Timestamp;
import java.util.Date;

public class Test {

    public static void main(String args[]) {
        Timestamp t = new Timestamp (Long.MIN_VALUE);
        System.out.println(t);
        System.out.println(new Date(t.getTime()));
    }

}
-------------------------------------------

------ jdk1.3 output ---------
--> /set/java/jdk1.3/solaris/bin/java -version
java version "1.3.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.0-C)
Java HotSpot(TM) Client VM (build 1.3.0-C, interpreted mode)

--> /set/java/jdk1.3/solaris/bin/java Test
292278994-08-17 07:12:55.192
Sun Aug 17 07:12:55 GMT+03:00 292278994

------ jdk1.4 output ---------
--> /set/jdk-builds/JDK1.4.0beta-b74/solaris/bin/java -version
java version "1.4.0-beta_refresh"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-beta_refresh-b74)
Java HotSpot(TM) Client VM (build 1.4.0-beta_refresh-b74, mixed mode)

--> /set/jdk-builds/JDK1.4.0beta-b74/solaris/bin/java Test
994-08-17 07:12:55.192
Sun Dec 02 19:47:04 GMT+03:00 292269055

Also, it should be documented what is the expected behavior of
the above methods if the time parameter is out of bounds.

======================================================================