Java Platform 1.2
Beta 4

Class java.sql.Timestamp

java.lang.Object
  |
  +--java.util.Date
        |
        +--java.sql.Timestamp

public class Timestamp
extends Date

This class is a thin wrapper around java.util.Date that allows JDBC to identify this as a SQL TIMESTAMP value. It adds the ability to hold the SQL TIMESTAMP nanos value and provides formatting and parsing operations to support the JDBC escape syntax for timestamp values.

Note: This type is a composite of a java.util.Date and a separate nanos value. Only integral seconds are stored in the java.util.Date component. The fractional seconds - the nanos - are separate. The getTime method will only return integral seconds. If a time value that includes the fractional seconds is desired you must convert nanos to milliseconds (nanos/1000000) and add this to the getTime value. Also note that the hashcode() method uses the underlying java.util.Data implementation and therefore does not include nanos in its computation.

See Also:
Serialized Form

Constructor Summary
Timestamp(int year, int month, int date, int hour, int minute, int second, int nano)
          Deprecated.  
Timestamp(long time)
          Construct a Timestamp using a milliseconds time value.
 
Method Summary
 boolean after(Timestamp ts)
          Is this timestamp later than the timestamp argument?
 boolean before(Timestamp ts)
          Is this timestamp earlier than the timestamp argument?
 boolean equals(Object ts)
          Test Timestamp values for equality.
 boolean equals(Timestamp ts)
          Test Timestamp values for equality
 int getNanos()
          Get the Timestamp's nanos value
 void setNanos(int n)
          Set the Timestamp's nanos value
 String toString()
          Format a timestamp in JDBC timestamp escape format
static Timestamp valueOf(String s)
          Convert a string in JDBC timestamp escape format to a Timestamp value
 
Methods inherited from class java.util.Date
after , before , compareTo , compareTo , getDate , getDay , getHours , getMinutes , getMonth , getSeconds , getTime , getTimezoneOffset , getYear , hashCode , parse , setDate , setHours , setMinutes , setMonth , setSeconds , setTime , setYear , toGMTString , toLocaleString , UTC
 
Methods inherited from class java.lang.Object
clone , finalize , getClass , notify , notifyAll , wait , wait , wait
 

Constructor Detail

Timestamp

public Timestamp(int year,
                 int month,
                 int date,
                 int hour,
                 int minute,
                 int second,
                 int nano)
Deprecated.  
Construct a Timestamp Object
Parameters:
year - year-1900
month - 0 to 11
day - 1 to 31
hour - 0 to 23
minute - 0 to 59
second - 0 to 59
nano - 0 to 999,999,999

Timestamp

public Timestamp(long time)
Construct a Timestamp using a milliseconds time value. The integral seconds are stored in the underlying date value; the fractional seconds are stored in the nanos value.
Parameters:
time - milliseconds since January 1, 1970, 00:00:00 GMT
Method Detail

valueOf

public static Timestamp valueOf(String s)
Convert a string in JDBC timestamp escape format to a Timestamp value
Parameters:
s - timestamp in format "yyyy-mm-dd hh:mm:ss.fffffffff"
Returns:
corresponding Timestamp

toString

public String toString()
Format a timestamp in JDBC timestamp escape format
Returns:
a String in yyyy-mm-dd hh:mm:ss.fffffffff format
Overrides:
toString in class Date

getNanos

public int getNanos()
Get the Timestamp's nanos value
Returns:
the Timestamp's fractional seconds component

setNanos

public void setNanos(int n)
Set the Timestamp's nanos value
Parameters:
n - the new fractional seconds component

equals

public boolean equals(Timestamp ts)
Test Timestamp values for equality
Parameters:
ts - the Timestamp value to compare with

equals

public boolean equals(Object ts)
Test Timestamp values for equality. This version of equals() has been added to fix the incorrect signature of Timestamp.equals(Timestamp) and preserve backward compatibility with existing class files.
Parameters:
ts - the Object value to compare with
Overrides:
equals in class Date

before

public boolean before(Timestamp ts)
Is this timestamp earlier than the timestamp argument?
Parameters:
ts - the Timestamp value to compare with

after

public boolean after(Timestamp ts)
Is this timestamp later than the timestamp argument?
Parameters:
ts - the Timestamp value to compare with

Java Platform 1.2
Beta 4

Submit a bug or feature
Submit comments/suggestions about new javadoc look
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.
This documentation was generated with a post-Beta4 version of Javadoc.