java.lang.Object java.util.Date java.sql.Timestamp
A thin wrapper around java.util.Date that allows the JDBC API to identify this as an 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 nanoseconds value. Only integral seconds are stored in the java.util.Date component. The fractional seconds - the nanos - are separate. The Timestamp.equals(Object) method never returns true when passed a value of type java.util.Date because the nanos component of a date is unknown. As a result, the Timestamp.equals(Object) method is not symmetric with respect to the java.util.Date.equals(Object) method. Also, the hashcode method uses the underlying
java.util.Date
java.util.Data
implementation and therefore does not include nanos in its computation.
Due to the differences between the Timestamp class and the java.util.Date class mentioned above, it is recommended that code not view Timestamp values generically as an instance of java.util.Date. The inheritance relationship between Timestamp and java.util.Date really denotes implementation inheritance, and not type inheritance.
Constructor Summary | |
---|---|
Timestamp
(int year, int month, int date, int hour, int minute, int second, int nano) Deprecated. instead use the constructor Timestamp(long millis) |
|
Timestamp
(long time) Constructs a Timestamp object using a milliseconds time value. |
Method Summary | |
---|---|
boolean |
after
(
Timestamp
ts) Indicates whether this Timestamp object is later than the given Timestamp object. |
boolean |
before
(
Timestamp
ts) Indicates whether this Timestamp object is earlier than the given Timestamp object. |
int |
compareTo
(
Object
o) Compares this Timestamp object to the given Object, which must be a Timestamp object. |
int |
compareTo
(
Timestamp
ts) Compares this Timestamp object to the given Timestamp object. |
boolean |
equals
(
Object
ts) Tests to see if this Timestamp object is equal to the given object. |
boolean |
equals
(
Timestamp
ts) Tests to see if this Timestamp object is equal to the given Timestamp object. |
int |
getNanos
() Gets this Timestamp object's nanos value. |
long |
getTime
() Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this Timestamp object. |
void |
setNanos
(int n) Sets this Timestamp object's nanos field to the given value. |
void |
setTime
(long time) Sets this Timestamp object to represent a point in time that is time milliseconds after January 1, 1970 00:00:00 GMT. |
String |
toString
() Formats a timestamp in JDBC timestamp escape format. |
static Timestamp |
valueOf
(
String
s) Converts a String object in JDBC timestamp escape format to a Timestamp value. |
Methods inherited from class java.util. Date |
---|
after , before , clone , compareTo , getDate , getDay , getHours , getMinutes , getMonth , getSeconds , getTimezoneOffset , getYear , hashCode , parse , setDate , setHours , setMinutes , setMonth , setSeconds , setYear , toGMTString , toLocaleString , UTC |
Methods inherited from class java.lang. Object |
---|
finalize , getClass , notify , notifyAll , wait , wait , wait |
Methods inherited from interface java.lang. Comparable |
---|
compareTo |
Constructor Detail |
---|
public Timestamp(int year, int month, int date, int hour, int minute, int second, int nano)
public Timestamp(long time)
Method Detail |
---|
public void setTime(long time)
public long getTime()
public static Timestamp valueOf(String s)
public String toString()
NOTE: To specify a timestamp for the class java.text.SimpleDateFormat, use "yyyy.MM.dd" rather than "yyyy-mm-dd". In the context of java.text.SimpleDateFormat, "mm" indicates minutes rather than the month. Note that java.text.SimpleDateFormat does not allow for the nanoseconds component of a Timestamp object. For Example:
Format Pattern Result -------------- ------ "yyyy.MM.dd G 'at' hh:mm:ss z" --> 2002.07.10 AD at 15:08:56 PDT
public int getNanos()
public void setNanos(int n)
public boolean equals(Timestamp ts)
public boolean equals(Object ts)
public boolean before(Timestamp ts)
public boolean after(Timestamp ts)
public int compareTo(Timestamp ts)
public int compareTo(Object o)