|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java.util.Date java.sql.Timestamp
public class 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
fractional seconds value, by allowing
the specification of fractional seconds to a precision of nanoseconds.
A Timestamp also provides formatting and
parsing operations to support the JDBC escape syntax for timestamp values.
The precision of a Timestamp object is calculated to be either:
19
, which is the number of characters in yyyy-mm-dd hh:mm:ss
20 + s
, which is the number
of characters in the yyyy-mm-dd hh:mm:ss.[fff...] and s
represents the scale of the given Timestamp,
its fractional seconds precision.
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 an object
that isn't an instance of java.sql.Timestamp
,
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
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(Date o)
Compares this Timestamp object to the given
Date , 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, 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 |
Constructor Detail |
---|
@Deprecated public Timestamp(int year, int month, int date, int hour, int minute, int second, int nano)
Timestamp(long millis)
Timestamp
object initialized
with the given values.
year
- the year minus 1900month
- 0 to 11date
- 1 to 31hour
- 0 to 23minute
- 0 to 59second
- 0 to 59nano
- 0 to 999,999,999
IllegalArgumentException
- if the nano argument is out of boundspublic Timestamp(long time)
Timestamp
object
using a milliseconds time value. The
integral seconds are stored in the underlying date value; the
fractional seconds are stored in the nanos
field of
the Timestamp
object.
time
- milliseconds since January 1, 1970, 00:00:00 GMT.
A negative number is the number of milliseconds before
January 1, 1970, 00:00:00 GMT.Calendar
Method Detail |
---|
public void setTime(long time)
Timestamp
object to represent a point in time that is
time milliseconds after January 1, 1970 00:00:00 GMT.
time
- the number of milliseconds.getTime()
,
Timestamp(long time)
,
Calendar
public long getTime()
Timestamp
object.
setTime(long)
public static Timestamp valueOf(String s)
String
object in JDBC timestamp escape format to a
Timestamp
value.
s
- timestamp in format yyyy-mm-dd hh:mm:ss[.f...]
. The
fractional seconds may be omitted.
Timestamp
value
IllegalArgumentException
- if the given argument
does not have the format yyyy-mm-dd hh:mm:ss[.f...]
public String toString()
yyyy-mm-dd hh:mm:ss.fffffffff
,
where ffffffffff
indicates nanoseconds.
String
object in
yyyy-mm-dd hh:mm:ss.fffffffff
formatDate.toLocaleString()
,
Date.toGMTString()
public int getNanos()
Timestamp
object's nanos
value.
Timestamp
object's fractional seconds componentsetNanos(int)
public void setNanos(int n)
Timestamp
object's nanos
field
to the given value.
n
- the new fractional seconds component
IllegalArgumentException
- if the given argument
is greater than 999999999 or less than 0getNanos()
public boolean equals(Timestamp ts)
Timestamp
object is
equal to the given Timestamp
object.
ts
- the Timestamp
value to compare with
true
if the given Timestamp
object is equal to this Timestamp
object;
false
otherwisepublic boolean equals(Object ts)
Timestamp
object is
equal to the given object.
This version of the method equals
has been added
to fix the incorrect
signature of Timestamp.equals(Timestamp)
and to preserve backward
compatibility with existing class files.
Note: This method is not symmetric with respect to the
equals(Object)
method in the base class.
ts
- the Object
value to compare with
true
if the given Object
is an instance
of a Timestamp
that
is equal to this Timestamp
object;
false
otherwiseDate.getTime()
public boolean before(Timestamp ts)
Timestamp
object is
earlier than the given Timestamp
object.
ts
- the Timestamp
value to compare with
true
if this Timestamp
object is earlier;
false
otherwisepublic boolean after(Timestamp ts)
Timestamp
object is
later than the given Timestamp
object.
ts
- the Timestamp
value to compare with
true
if this Timestamp
object is later;
false
otherwisepublic int compareTo(Timestamp ts)
Timestamp
object to the given
Timestamp
object.
ts
- the Timestamp
object to be compared to
this Timestamp
object
0
if the two Timestamp
objects are equal; a value less than 0
if this
Timestamp
object is before the given argument;
and a value greater than 0
if this
Timestamp
object is after the given argument.public int compareTo(Date o)
Timestamp
object to the given
Date
, which must be a Timestamp
object. If the argument is not a Timestamp
object,
this method throws a ClassCastException
object.
(Timestamp
objects are
comparable only to other Timestamp
objects.)
compareTo
in interface Comparable<Date>
compareTo
in class Date
o
- the Date
to be compared, which must be a
Timestamp
object
0
if this Timestamp
object
and the given object are equal; a value less than 0
if this Timestamp
object is before the given argument;
and a value greater than 0
if this
Timestamp
object is after the given argument.
|
Java™ Platform Standard Ed. 6 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.