java.util.Datejava.sql.Timestamp| Java™ Platform Standard Ed. 6 | ||||||||||
java.lang.Object
public classTimestamp
A thin wrapper aroundjava.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 ajava.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 theTimestamp 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.
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. | |
after(Timestamp ts)Indicates whether this Timestamp object is later than the givenTimestamp object. | |
before(Timestamp ts)Indicates whether this Timestamp object is earlier than the givenTimestamp object. | |
compareTo(Date o)Compares this Timestamp object to the givenDate, which must be aTimestamp object. | |
compareTo(Timestamp ts)Compares this Timestamp object to the givenTimestamp object. | |
equals(Object ts)Tests to see if this Timestamp object is equal to the given object. | |
equals(Timestamp ts)Tests to see if this Timestamp object is equal to the givenTimestamp object. | |
getNanos()Gets this Timestamp object'snanos value. | |
getTime()Returns the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by this Timestamp object. | |
setNanos(int n)Sets this Timestamp object'snanos field to the given value. | |
setTime(long time)Sets this Timestamp object to represent a point in time that istime milliseconds after January 1, 1970 00:00:00 GMT. | |
toString()Formats a timestamp in JDBC timestamp escape format. | |
valueOf(String s)Converts a String 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,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 |
publicTimestamp(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,999IllegalArgumentException - if the nano argument is out of boundspublicTimestamp(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 thenanos field of theTimestamp 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.Calendarpublic voidsetTime(long time)
Timestamp object to represent a point in time that istime milliseconds after January 1, 1970 00:00:00 GMT.setTime in classDatetime - the number of milliseconds.getTime(),Timestamp(long time),Calendarpublic longgetTime()
Timestamp object.getTime in classDatesetTime(long)public staticTimestampvalueOf(String s)
String object in JDBC timestamp escape format to aTimestamp value.s - timestamp in formatyyyy-mm-dd hh:mm:ss[.f...]. The fractional seconds may be omitted.Timestamp valueIllegalArgumentException - if the given argument does not have the formatyyyy-mm-dd hh:mm:ss[.f...]publicStringtoString()
yyyy-mm-dd hh:mm:ss.fffffffff, whereffffffffff indicates nanoseconds.toString in classDateString object inyyyy-mm-dd hh:mm:ss.fffffffff formatDate.toLocaleString(),Date.toGMTString()public intgetNanos()
Timestamp object'snanos value.Timestamp object's fractional seconds componentsetNanos(int)public voidsetNanos(int n)
Timestamp object'snanos field to the given value.n - the new fractional seconds componentIllegalArgumentException - if the given argument is greater than 999999999 or less than 0getNanos()public booleanequals(Timestamp ts)
Timestamp object is equal to the givenTimestamp object.ts - theTimestamp value to compare withtrue if the givenTimestamp object is equal to thisTimestamp object;false otherwisepublic booleanequals(Object ts)
Timestamp 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.equals in classDatets - theObject value to compare withtrue if the givenObject is an instance of aTimestamp that is equal to thisTimestamp object;false otherwiseDate.getTime()public booleanbefore(Timestamp ts)
Timestamp object is earlier than the givenTimestamp object.ts - theTimestamp value to compare withtrue if thisTimestamp object is earlier;false otherwisepublic booleanafter(Timestamp ts)
Timestamp object is later than the givenTimestamp object.ts - theTimestamp value to compare withtrue if thisTimestamp object is later;false otherwisepublic intcompareTo(Timestamp ts)
Timestamp object to the givenTimestamp object.ts - theTimestamp object to be compared to thisTimestamp object0 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.public intcompareTo(Date o)
Timestamp object to the givenDate, which must be aTimestamp object. If the argument is not aTimestamp object, this method throws aClassCastException object. (Timestamp objects are comparable only to otherTimestamp objects.)compareTo in interfaceComparable<Date>compareTo in classDateo - theDate to be compared, which must be aTimestamp object0 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.| Java™ Platform Standard Ed. 6 | ||||||||||