- java.lang.Object
-
- java.util.Date
-
- java.sql.Timestamp
-
- All Implemented Interfaces:
- Serializable, Cloneable, Comparable<Date>
public class Timestamp extends Date
A thin wrapper around
java.util.Date
that allows the JDBC API to identify this as an SQLTIMESTAMP
value. It adds the ability to hold the SQLTIMESTAMP
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...] ands
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 thejava.util.Date
component. The fractional seconds - the nanos - are separate. TheTimestamp.equals(Object)
method never returnstrue
when passed an object that isn't an instance ofjava.sql.Timestamp
, because the nanos component of a date is unknown. As a result, theTimestamp.equals(Object)
method is not symmetric with respect to thejava.util.Date.equals(Object)
method. Also, thehashCode
method uses the underlyingjava.util.Date
implementation and therefore does not include nanos in its computation.Due to the differences between the
Timestamp
class and thejava.util.Date
class mentioned above, it is recommended that code not viewTimestamp
values generically as an instance ofjava.util.Date
. The inheritance relationship betweenTimestamp
andjava.util.Date
really denotes implementation inheritance, and not type inheritance.- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description Timestamp(int year, int month, int date, int hour, int minute, int second, int nano)
Deprecated.instead use the constructorTimestamp(long millis)
Timestamp(long time)
Constructs aTimestamp
object using a milliseconds time value.
-
Method Summary
Methods Modifier and Type Method and Description boolean
after(Timestamp ts)
Indicates whether thisTimestamp
object is later than the givenTimestamp
object.boolean
before(Timestamp ts)
Indicates whether thisTimestamp
object is earlier than the givenTimestamp
object.int
compareTo(Date o)
Compares thisTimestamp
object to the givenDate
object.int
compareTo(Timestamp ts)
Compares thisTimestamp
object to the givenTimestamp
object.boolean
equals(Object ts)
Tests to see if thisTimestamp
object is equal to the given object.boolean
equals(Timestamp ts)
Tests to see if thisTimestamp
object is equal to the givenTimestamp
object.int
getNanos()
Gets thisTimestamp
object'snanos
value.long
getTime()
Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by thisTimestamp
object.int
hashCode()
Returns a hash code value for this object.void
setNanos(int n)
Sets thisTimestamp
object'snanos
field to the given value.void
setTime(long time)
Sets thisTimestamp
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 aString
object in JDBC timestamp escape format to aTimestamp
value.-
Methods inherited from class java.util.Date
after, before, clone, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTimezoneOffset, getYear, parse, setDate, setHours, setMinutes, setMonth, setSeconds, setYear, toGMTString, toLocaleString, UTC
-
-
-
-
Constructor Detail
-
Timestamp
@Deprecated public Timestamp(int year, int month, int date, int hour, int minute, int second, int nano)
Deprecated. instead use the constructorTimestamp(long millis)
Constructs aTimestamp
object initialized with the given values.- Parameters:
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- Throws:
IllegalArgumentException
- if the nano argument is out of bounds
-
Timestamp
public Timestamp(long time)
Constructs aTimestamp
object using a milliseconds time value. The integral seconds are stored in the underlying date value; the fractional seconds are stored in thenanos
field of theTimestamp
object.- Parameters:
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.- See Also:
Calendar
-
-
Method Detail
-
setTime
public void setTime(long time)
Sets thisTimestamp
object to represent a point in time that is time milliseconds after January 1, 1970 00:00:00 GMT.- Overrides:
setTime
in classDate
- Parameters:
time
- the number of milliseconds.- See Also:
getTime()
,Timestamp(long time)
,Calendar
-
getTime
public long getTime()
Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by thisTimestamp
object.- Overrides:
getTime
in classDate
- Returns:
- the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this date.
- See Also:
setTime(long)
-
valueOf
public static Timestamp valueOf(String s)
Converts aString
object in JDBC timestamp escape format to aTimestamp
value.- Parameters:
s
- timestamp in formatyyyy-[m]m-[d]d hh:mm:ss[.f...]
. The fractional seconds may be omitted. The leading zero formm
anddd
may also be omitted.- Returns:
- corresponding
Timestamp
value - Throws:
IllegalArgumentException
- if the given argument does not have the formatyyyy-[m]m-[d]d hh:mm:ss[.f...]
-
toString
public String toString()
Formats a timestamp in JDBC timestamp escape format.yyyy-mm-dd hh:mm:ss.fffffffff
, whereffffffffff
indicates nanoseconds.- Overrides:
toString
in classDate
- Returns:
- a
String
object inyyyy-mm-dd hh:mm:ss.fffffffff
format - See Also:
Date.toLocaleString()
,Date.toGMTString()
-
getNanos
public int getNanos()
Gets thisTimestamp
object'snanos
value.- Returns:
- this
Timestamp
object's fractional seconds component - See Also:
setNanos(int)
-
setNanos
public void setNanos(int n)
Sets thisTimestamp
object'snanos
field to the given value.- Parameters:
n
- the new fractional seconds component- Throws:
IllegalArgumentException
- if the given argument is greater than 999999999 or less than 0- See Also:
getNanos()
-
equals
public boolean equals(Timestamp ts)
Tests to see if thisTimestamp
object is equal to the givenTimestamp
object.- Parameters:
ts
- theTimestamp
value to compare with- Returns:
true
if the givenTimestamp
object is equal to thisTimestamp
object;false
otherwise
-
equals
public boolean equals(Object ts)
Tests to see if thisTimestamp
object is equal to the given object. This version of the methodequals
has been added to fix the incorrect signature ofTimestamp.equals(Timestamp)
and to preserve backward compatibility with existing class files. Note: This method is not symmetric with respect to theequals(Object)
method in the base class.- Overrides:
equals
in classDate
- Parameters:
ts
- theObject
value to compare with- Returns:
true
if the givenObject
is an instance of aTimestamp
that is equal to thisTimestamp
object;false
otherwise- See Also:
Date.getTime()
-
before
public boolean before(Timestamp ts)
Indicates whether thisTimestamp
object is earlier than the givenTimestamp
object.- Parameters:
ts
- theTimestamp
value to compare with- Returns:
true
if thisTimestamp
object is earlier;false
otherwise
-
after
public boolean after(Timestamp ts)
Indicates whether thisTimestamp
object is later than the givenTimestamp
object.- Parameters:
ts
- theTimestamp
value to compare with- Returns:
true
if thisTimestamp
object is later;false
otherwise
-
compareTo
public int compareTo(Timestamp ts)
Compares thisTimestamp
object to the givenTimestamp
object.- Parameters:
ts
- theTimestamp
object to be compared to thisTimestamp
object- Returns:
- the value
0
if the twoTimestamp
objects are equal; a value less than0
if thisTimestamp
object is before the given argument; and a value greater than0
if thisTimestamp
object is after the given argument. - Since:
- 1.4
-
compareTo
public int compareTo(Date o)
Compares thisTimestamp
object to the givenDate
object.- Specified by:
compareTo
in interfaceComparable<Date>
- Overrides:
compareTo
in classDate
- Parameters:
o
- theDate
to be compared to thisTimestamp
object- Returns:
- the value
0
if thisTimestamp
object and the given object are equal; a value less than0
if thisTimestamp
object is before the given argument; and a value greater than0
if thisTimestamp
object is after the given argument. - Since:
- 1.5
-
hashCode
public int hashCode()
Returns a hash code value for this object. The result is the exclusive OR of the two halves of the primitive long value returned by theDate.getTime()
method. That is, the hash code is the value of the expression:
The(int)(this.getTime()^(this.getTime() >>> 32))
hashCode
method uses the underlyingjava.util.Date
implementation and therefore does not include nanos in its computation.- Overrides:
hashCode
in classDate
- Returns:
- a hash code value for this object.
- See Also:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-java/sql/Timestamp.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.