- All Implemented Interfaces:
- Serializable,- Cloneable,- Comparable<Date>
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...] andsrepresents 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.
- Since:
- 1.1
- See Also:
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionbooleanIndicates whether thisTimestampobject is later than the givenTimestampobject.booleanIndicates whether thisTimestampobject is earlier than the givenTimestampobject.intCompares thisTimestampobject to the givenTimestampobject.intCompares thisTimestampobject to the givenDateobject.booleanTests to see if thisTimestampobject is equal to the given object.booleanTests to see if thisTimestampobject is equal to the givenTimestampobject.static TimestampObtains an instance ofTimestampfrom anInstantobject.intgetNanos()Gets thisTimestampobject'snanosvalue.longgetTime()Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by thisTimestampobject.inthashCode()Returns a hash code value for this object.voidsetNanos(int n) Sets thisTimestampobject'snanosfield to the given value.voidsetTime(long time) Sets thisTimestampobject to represent a point in time that istimemilliseconds after January 1, 1970 00:00:00 GMT.Converts thisTimestampobject to anInstant.Converts thisTimestampobject to aLocalDateTime.toString()Formats a timestamp in JDBC timestamp escape format.static TimestampConverts aStringobject in JDBC timestamp escape format to aTimestampvalue.static TimestampvalueOf(LocalDateTime dateTime) Obtains an instance ofTimestampfrom aLocalDateTimeobject, with the same year, month, day of month, hours, minutes, seconds and nanos date-time value as the providedLocalDateTime.Methods declared in class java.util.Dateafter, before, clone, getDate, getDay, getHours, getMinutes, getMonth, getSeconds, getTimezoneOffset, getYear, parse, setDate, setHours, setMinutes, setMonth, setSeconds, setYear, toGMTString, toLocaleString, UTC
- 
Constructor Details- 
Timestamp@Deprecated(since="1.2") public Timestamp(int year, int month, int date, int hour, int minute, int second, int nano) Deprecated.instead use the constructorTimestamp(long millis)Constructs aTimestampobject initialized with the given values.- Parameters:
- year- the year minus 1900
- month- 0 to 11
- date- 1 to 31
- hour- 0 to 23
- minute- 0 to 59
- second- 0 to 59
- nano- 0 to 999,999,999
- Throws:
- IllegalArgumentException- if the nano argument is out of bounds
 
- 
Timestamppublic Timestamp(long time) Constructs aTimestampobject using a milliseconds time value. The integral seconds are stored in the underlying date value; the fractional seconds are stored in thenanosfield of theTimestampobject.- 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:
 
 
- 
- 
Method Details- 
setTimepublic void setTime(long time) Sets thisTimestampobject to represent a point in time that istimemilliseconds after January 1, 1970 00:00:00 GMT.
- 
getTimepublic long getTime()Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by thisTimestampobject.
- 
valueOfConverts aStringobject in JDBC timestamp escape format to aTimestampvalue.- Parameters:
- s- timestamp in format- yyyy-[m]m-[d]d hh:mm:ss[.f...]. The fractional seconds may be omitted. The leading zero for- mmand- ddmay also be omitted.
- Returns:
- corresponding Timestampvalue
- Throws:
- IllegalArgumentException- if the given argument does not have the format- yyyy-[m]m-[d]d hh:mm:ss[.f...]
 
- 
toStringFormats a timestamp in JDBC timestamp escape format.yyyy-mm-dd hh:mm:ss.fffffffff, wherefffffffffindicates nanoseconds.
- 
getNanospublic int getNanos()Gets thisTimestampobject'snanosvalue.- Returns:
- this Timestampobject's fractional seconds component
- See Also:
 
- 
setNanospublic void setNanos(int n) Sets thisTimestampobject'snanosfield 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:
 
- 
equalsTests to see if thisTimestampobject is equal to the givenTimestampobject.- Parameters:
- ts- the- Timestampvalue to compare with
- Returns:
- trueif the given- Timestampobject is equal to this- Timestampobject;- falseotherwise
 
- 
equalsTests to see if thisTimestampobject is equal to the given object. This version of the methodequalshas 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.
- 
beforeIndicates whether thisTimestampobject is earlier than the givenTimestampobject.- Parameters:
- ts- the- Timestampvalue to compare with
- Returns:
- trueif this- Timestampobject is earlier;- falseotherwise
 
- 
afterIndicates whether thisTimestampobject is later than the givenTimestampobject.- Parameters:
- ts- the- Timestampvalue to compare with
- Returns:
- trueif this- Timestampobject is later;- falseotherwise
 
- 
compareToCompares thisTimestampobject to the givenTimestampobject.- Parameters:
- ts- the- Timestampobject to be compared to this- Timestampobject
- Returns:
- the value 0if the twoTimestampobjects are equal; a value less than0if thisTimestampobject is before the given argument; and a value greater than0if thisTimestampobject is after the given argument.
- Since:
- 1.4
 
- 
compareToCompares thisTimestampobject to the givenDateobject.- Specified by:
- compareToin interface- Comparable<Date>
- Overrides:
- compareToin class- Date
- Parameters:
- o- the- Dateto be compared to this- Timestampobject
- Returns:
- the value 0if thisTimestampobject and the given object are equal; a value less than0if thisTimestampobject is before the given argument; and a value greater than0if thisTimestampobject is after the given argument.
- Since:
- 1.5
 
- 
hashCodepublic int hashCode()Returns a hash code value for this object. The result is the exclusive OR of the two halves of the primitivelongvalue returned by theDate.getTime()method. That is, the hash code is the value of the expression:
 The(int)(this.getTime()^(this.getTime() >>> 32))hashCodemethod uses the underlyingjava.util.Dateimplementation and therefore does not include nanos in its computation.
- 
valueOfObtains an instance ofTimestampfrom aLocalDateTimeobject, with the same year, month, day of month, hours, minutes, seconds and nanos date-time value as the providedLocalDateTime.The provided LocalDateTimeis interpreted as the local date-time in the local time zone.- Parameters:
- dateTime- a- LocalDateTimeto convert
- Returns:
- a Timestampobject
- Throws:
- NullPointerException- if- dateTimeis null.
- Since:
- 1.8
 
- 
toLocalDateTimeConverts thisTimestampobject to aLocalDateTime.The conversion creates a LocalDateTimethat represents the same year, month, day of month, hours, minutes, seconds and nanos date-time value as thisTimestampin the local time zone.- Returns:
- a LocalDateTimeobject representing the same date-time value
- Since:
- 1.8
 
- 
fromObtains an instance ofTimestampfrom anInstantobject.Instantcan store points on the time-line further in the future and further in the past thanDate. In this scenario, this method will throw an exception.- Parameters:
- instant- the instant to convert
- Returns:
- an Timestamprepresenting the same point on the time-line as the provided instant
- Throws:
- NullPointerException- if- instantis null.
- IllegalArgumentException- if the instant is too large to represent as a- Timestamp
- Since:
- 1.8
 
- 
toInstantConverts thisTimestampobject to anInstant.The conversion creates an Instantthat represents the same point on the time-line as thisTimestamp.
 
- 
Timestamp(long millis)