- 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.Datethat allows the JDBC API to identify this as an SQLTIMESTAMPvalue. It adds the ability to hold the SQLTIMESTAMPfractional 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.Dateand a separate nanoseconds value. Only integral seconds are stored in thejava.util.Datecomponent. The fractional seconds - the nanos - are separate. TheTimestamp.equals(Object)method never returnstruewhen 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, thehashCodemethod uses the underlyingjava.util.Dateimplementation and therefore does not include nanos in its computation.Due to the differences between the Timestampclass and thejava.util.Dateclass mentioned above, it is recommended that code not viewTimestampvalues generically as an instance ofjava.util.Date. The inheritance relationship betweenTimestampandjava.util.Datereally denotes implementation inheritance, and not type inheritance.- Since:
- 1.1
- See Also:
- Serialized Form
 
- 
- 
Method SummaryAll Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description booleanafter(Timestamp ts)Indicates whether thisTimestampobject is later than the givenTimestampobject.booleanbefore(Timestamp ts)Indicates whether thisTimestampobject is earlier than the givenTimestampobject.intcompareTo(Timestamp ts)Compares thisTimestampobject to the givenTimestampobject.intcompareTo(Date o)Compares thisTimestampobject to the givenDateobject.booleanequals(Object ts)Tests to see if thisTimestampobject is equal to the given object.booleanequals(Timestamp ts)Tests to see if thisTimestampobject is equal to the givenTimestampobject.static Timestampfrom(Instant instant)Obtains 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.InstanttoInstant()Converts thisTimestampobject to anInstant.LocalDateTimetoLocalDateTime()Converts thisTimestampobject to aLocalDateTime.StringtoString()Formats a timestamp in JDBC timestamp escape format.static TimestampvalueOf(String s)Converts 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 Detail- 
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:
- Calendar
 
 
- 
 - 
Method Detail- 
setTimepublic void setTime(long time) Sets thisTimestampobject to represent a point in time that istimemilliseconds after January 1, 1970 00:00:00 GMT.- Overrides:
- setTimein class- Date
- Parameters:
- time- the number of milliseconds.
- See Also:
- getTime(),- Timestamp(long time),- Calendar
 
 - 
getTimepublic long getTime() Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by thisTimestampobject.- Overrides:
- getTimein class- Date
- Returns:
- the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this date.
- See Also:
- setTime(long)
 
 - 
valueOfpublic static Timestamp valueOf(String s) Converts 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...]
 
 - 
toStringpublic String toString() Formats a timestamp in JDBC timestamp escape format.yyyy-mm-dd hh:mm:ss.fffffffff, wherefffffffffindicates nanoseconds.- Overrides:
- toStringin class- Date
- Returns:
- a Stringobject inyyyy-mm-dd hh:mm:ss.fffffffffformat
- See Also:
- Date.toLocaleString(),- Date.toGMTString()
 
 - 
getNanospublic int getNanos() Gets thisTimestampobject'snanosvalue.- Returns:
- this Timestampobject's fractional seconds component
- See Also:
- setNanos(int)
 
 - 
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:
- getNanos()
 
 - 
equalspublic boolean equals(Timestamp ts) Tests 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
 
 - 
equalspublic boolean equals(Object ts) Tests 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.- Overrides:
- equalsin class- Date
- Parameters:
- ts- the- Objectvalue to compare with
- Returns:
- trueif the given- Objectis an instance of a- Timestampthat is equal to this- Timestampobject;- falseotherwise
- See Also:
- Date.getTime()
 
 - 
beforepublic boolean before(Timestamp ts) Indicates whether thisTimestampobject is earlier than the givenTimestampobject.- Parameters:
- ts- the- Timestampvalue to compare with
- Returns:
- trueif this- Timestampobject is earlier;- falseotherwise
 
 - 
afterpublic boolean after(Timestamp ts) Indicates whether thisTimestampobject is later than the givenTimestampobject.- Parameters:
- ts- the- Timestampvalue to compare with
- Returns:
- trueif this- Timestampobject is later;- falseotherwise
 
 - 
compareTopublic int compareTo(Timestamp ts) Compares 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
 
 - 
compareTopublic int compareTo(Date o) Compares 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.- Overrides:
- hashCodein class- Date
- Returns:
- a hash code value for this object.
- See Also:
- Object.equals(java.lang.Object),- System.identityHashCode(java.lang.Object)
 
 - 
valueOfpublic static Timestamp valueOf(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.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
 
 - 
toLocalDateTimepublic LocalDateTime toLocalDateTime() Converts 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
 
 - 
frompublic static Timestamp from(Instant instant) Obtains 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
 
 
- 
 
-