Adaptive Server versions 12.5.1 and later offer support for the SQL date and time datatypes. Previously, Adaptive Server offered only support for the datetime and smalldatetime datatypes. These datatypes were limited for the following reasons:
There was no way to have separate time and date datatypes.
Dates prior to 1/1/1753 were illegal. datetime values could hold only dates between 1/1/1753 and 12/31/9999.
When JDBC clients used the setTime and setDate methods to insert java.sql.Time or java.sql.Date methods, the values were converted to datetime datatypes in the server. This conversion resulted in the addition of a default date or time to the insert value supplied by the client.
The addition of the date and time datatypes provides the following advantages:
Date values can now be between Jan. 1, 0001 and Dec. 31, 9999, exactly matching the allowable values in java.sql.Date.
A direct mapping now exists between java.sql.Date and the date dataype, as well as between java.sql.Time and the time datatype.
To use the date and time datatypes with jConnect 6.0, make sure your JCONNECT_VERSION property is set to the default “6”.
If you select from a table that contains a date or time column, and you have not enabled date/time support in jConnect (by setting the version), the server tries to convert the date or time to a datetime value before returning it. This can cause problems if the date to be returned is prior to 1/1/1753. In that case, a conversion error occurs, and the database informs you of the error.
Adaptive Server Anywhere supports a date and time datatype, but the date and time datatypes are not yet directly compatible with those in Adaptive Server version 12.5.1 and later. Using jConnect, you should continue to use the datetime and smalldatetime datatypes when communicating with Adaptive Server Anywhere.
The maximum value in a datetime column in Adaptive Server Anywhere is 1-1-7911 00:00:00.
Using jConnect, you receive conversion errors if you attempt to insert dates prior to 1/1/1753 into datetime columns or parameters.
Refer to the Adaptive Server manuals for more information on the date and time datatypes; of special note is the section on allowable implicit conversions.
If you use getObject with an Adaptive Server date, time, or datetime column, the value returned is, respectively, a java.sql.Date, java.sql.Time, or java.sql.Timestamp datatype.
