Summary: Ctors | Methods | Inherited Methods | [Expand All]

public class

Timestamp

extends Date

java.lang.Object
↳	java.util.Date
	↳	java.sql.Timestamp

Class Overview

A Java representation of the SQL TIMESTAMP type. It provides the capability to represent the SQL TIMESTAMP nanosecond value, in addition to the regular date/time value which has millisecond resolution.

The Timestamp class consists of a regular Date/Time value, where only the integral seconds value is stored, plus a nanoseconds value where the fractional seconds are stored.

The addition of the nanosecond value field to the Timestamp object makes it significantly different from the java.util.Date object which it extends. Users should be cautious in their use of Timestamp objects and should not assume that they are interchangeable with java.util.Date objects when used outside the confines of the java.sql package.

Summary

Public Constructors
	Timestamp(int theYear, int theMonth, int theDate, int theHour, int theMinute, int theSecond, int theNano) This constructor is deprecated. Please use the constructor Timestamp(long) Returns a Timestamp corresponding to the time specified by the supplied values for Year, Month, Date, Hour, Minutes, Seconds and Nanoseconds
	Timestamp(long theTime) Returns a Timestamp object corresponding to the time represented by a supplied time value.

Public Methods
boolean	after(Timestamp theTimestamp) Returns true if this timestamp object is later than the supplied timestamp, otherwise returns false.
boolean	before(Timestamp theTimestamp) Returns true if this timestamp object is earlier than the supplied timestamp, otherwise returns false.
int	compareTo(Date theObject) Compares this Timestamp object with a supplied Timestamp object
int	compareTo(Timestamp theTimestamp) Compares this Timestamp object with a supplied Timestamp object
boolean	equals(Object theObject) Tests to see if this timestamp is equal to a supplied object.
boolean	equals(Timestamp theTimestamp) Tests to see if this timestamp is equal to a supplied timestamp.
int	getNanos() Gets this Timestamp's nanosecond value
long	getTime() Returns the time represented by this Timestamp object, as a long value containing the number of milliseconds since the Epoch (January 1 1970, 00:00:00.000 GMT)
void	setNanos(int n) Sets the nanosecond value for this timestamp
void	setTime(long theTime) Sets the time represented by this Timestamp object to the supplied time, defined as the number of milliseconds since the Epoch (January 1 1970, 00:00:00.000 GMT)
String	toString() Returns the timestamp formatted as a String in the JDBC Timestamp Escape format, which is of the form "yyyy-mm-dd hh:mm:ss.nnnnnnnnn"
static Timestamp	valueOf(String s) Creates a Timestamp object with a time value equal to the time specified by a supplied String holding the time in JDBC timestamp escape format, which is of the form "yyyy-mm-dd hh:mm:ss.nnnnnnnnn"

[Expand]

Inherited Methods

From class java.util.Date

static long	UTC(int year, int month, int day, int hour, int minute, int second) This method is deprecated. use: `Calendar cal = new GregorianCalendar(TimeZone.getTimeZone("GMT")); cal.set(year + 1900, month, day, hour, minute, second); cal.getTime().getTime();`
boolean	after(Date date) Returns if this Date is after the specified Date.
boolean	before(Date date) Boolean indication of whether or not this `Date` occurs earlier than the `Date` argument.
Object	clone() Returns a new Date with the same millisecond value as this Date.
int	compareTo(Date date) Compare the receiver to the specified Date to determine the relative ordering.
boolean	equals(Object object) Compares the specified object to this Date and answer if they are equal.
int	getDate() This method is deprecated. use Calendar.get(Calendar.DATE)
int	getDay() This method is deprecated. use Calendar.get(Calendar.DAY_OF_WEEK)
int	getHours() This method is deprecated. use Calendar.get(Calendar.HOUR_OF_DAY)
int	getMinutes() This method is deprecated. use Calendar.get(Calendar.MINUTE)
int	getMonth() This method is deprecated. use Calendar.get(Calendar.MONTH)
int	getSeconds() This method is deprecated. use Calendar.get(Calendar.SECOND)
long	getTime() Returns this Date as a millisecond value.
int	getTimezoneOffset() This method is deprecated. use `(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / 60000`
int	getYear() This method is deprecated. use `Calendar.get(Calendar.YEAR) - 1900`
int	hashCode() Returns an integer hash code for the receiver.
static long	parse(String string) This method is deprecated. use DateFormat
void	setDate(int day) This method is deprecated. use Calendar.set(Calendar.DATE, day)
void	setHours(int hour) This method is deprecated. use Calendar.set(Calendar.HOUR_OF_DAY, hour)
void	setMinutes(int minute) This method is deprecated. use Calendar.set(Calendar.MINUTE, minute)
void	setMonth(int month) This method is deprecated. use Calendar.set(Calendar.MONTH, month)
void	setSeconds(int second) This method is deprecated. use Calendar.set(Calendar.SECOND, second)
void	setTime(long milliseconds) Sets this Date to the specified millisecond value.
void	setYear(int year) This method is deprecated. use Calendar.set(Calendar.YEAR, year + 1900)
String	toGMTString() This method is deprecated. use DateFormat
String	toLocaleString() This method is deprecated. use DateFormat
String	toString() Returns the string representation of this Date in the format: Tue Jun 22 13:07:00 GMT 1999

From class java.lang.Object

Object	clone() Returns a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o) Compares the argument to the receiver, and returns true if they represent the same object using a class specific comparison.
void	finalize() Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final Class<? extends Object>	getClass() Returns the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode() Returns an integer hash code for the receiver.
final void	notify() Causes one thread which is `wait` ing on the receiver to be made ready to run.
final void	notifyAll() Causes all threads which are `wait` ing on the receiver to be made ready to run.
String	toString() Returns a string containing a concise, human-readable description of the receiver.
final void	wait(long time, int frac) Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final void	wait(long time) Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final void	wait() Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

From interface java.lang.Comparable

Public Constructors

public Timestamp (int theYear, int theMonth, int theDate, int theHour, int theMinute, int theSecond, int theNano)

This constructor is deprecated.Please use the constructor Timestamp(long) Returns a Timestamp corresponding to the time specified by the supplied values for Year, Month, Date, Hour, Minutes, Seconds and Nanoseconds

Parameters

theYear	specified as the year minus 1900
theMonth	specified as an integer in the range 0 - 11
theDate	specified as an integer in the range 1 - 31
theHour	specified as an integer in the range 0 - 23
theMinute	specified as an integer in the range 0 - 59
theSecond	specified as an integer in the range 0 - 59
theNano	which defines the nanosecond value of the timestamp specified as an integer in the range 0 - 999,999,999

Throws

IllegalArgumentException	if any of the parameters is out of range

public Timestamp (long theTime)

Returns a Timestamp object corresponding to the time represented by a supplied time value.

Parameters

theTime	a time value in the format of milliseconds since the Epoch (January 1 1970 00:00:00.000 GMT)

Public Methods

public boolean after (Timestamp theTimestamp)

Returns true if this timestamp object is later than the supplied timestamp, otherwise returns false.

Parameters

theTimestamp	the timestamp to compare with this timestamp object

Returns

true if this timestamp object is later than the supplied timestamp, false otherwise

public boolean before (Timestamp theTimestamp)

Returns true if this timestamp object is earlier than the supplied timestamp, otherwise returns false.

Parameters

theTimestamp	the timestamp to compare with this timestamp object

Returns

true if this timestamp object is earlier than the supplied timestamp, false otherwise

public int compareTo (Date theObject)

Compares this Timestamp object with a supplied Timestamp object

Parameters

theObject	the timestamp to compare with this timestamp object, passed in as an Object

Returns

0 if the two Timestamp objects are equal in time, a value <0 if this Timestamp object is before the supplied Timestamp and a value >0 if this Timestamp object is after the supplied Timestamp

Throws

ClassCastException	if the supplied object is not a Timestamp object

public int compareTo (Timestamp theTimestamp)

Compares this Timestamp object with a supplied Timestamp object

Parameters

theTimestamp	the timestamp to compare with this timestamp object, passed in as a Timestamp

Returns

0 if the two Timestamp objects are equal in time, a value <0 if this Timestamp object is before the supplied Timestamp and a value >0 if this Timestamp object is after the supplied Timestamp

public boolean equals (Object theObject)

Tests to see if this timestamp is equal to a supplied object.

Parameters

theObject	the object to compare with this object

Returns

true if this Timestamp object is equal to the supplied Timestamp object false if the object is not a Timestamp object or if the object is a Timestamp but represents a different instant in time

public boolean equals (Timestamp theTimestamp)

Tests to see if this timestamp is equal to a supplied timestamp.

Parameters

theTimestamp	the timestamp to compare with this timestamp object, passed in as an Object

Returns

true if this Timestamp object is equal to the supplied Timestamp object

public int getNanos ()

Gets this Timestamp's nanosecond value

Returns

The timestamp's nanosecond value, an integer between 0 and 999,999,999

public long getTime ()

Returns the time represented by this Timestamp object, as a long value containing the number of milliseconds since the Epoch (January 1 1970, 00:00:00.000 GMT)

Returns

the number of milliseconds since Jan. 1, 1970 GMT.

public void setNanos (int n)

Sets the nanosecond value for this timestamp

Parameters

n	number of nanoseconds

Throws

IllegalArgumentException	if number of nanoseconds smaller than 0 or greater than 999999999

public void setTime (long theTime)

Sets the time represented by this Timestamp object to the supplied time, defined as the number of milliseconds since the Epoch (January 1 1970, 00:00:00.000 GMT)

Parameters

theTime	the number of milliseconds since Jan. 1, 1970 GMT.

public String toString ()

Returns the timestamp formatted as a String in the JDBC Timestamp Escape format, which is of the form "yyyy-mm-dd hh:mm:ss.nnnnnnnnn"

Returns

A string representing the instant defined by the Timestamp, in JDBC Timestamp escape format

public static Timestamp valueOf (String s)

Creates a Timestamp object with a time value equal to the time specified by a supplied String holding the time in JDBC timestamp escape format, which is of the form "yyyy-mm-dd hh:mm:ss.nnnnnnnnn"

Parameters

s	the String containing a time in JDBC timestamp escape format

Returns

A timestamp object with time value as defined by the supplied String

Throws

IllegalArgumentException	if the provided String is null

Feb	MAR	Apr
	09
2008	2009	2010

Interfaces

Classes

Exceptions

Timestamp

Class Overview

Summary

Public Constructors

public Timestamp (int theYear, int theMonth, int theDate, int theHour, int theMinute, int theSecond, int theNano)

Parameters

Throws

public Timestamp (long theTime)

Parameters

Public Methods

public boolean after (Timestamp theTimestamp)

Parameters

Returns

public boolean before (Timestamp theTimestamp)

Parameters

Returns

public int compareTo (Date theObject)

Parameters

Returns

Throws

public int compareTo (Timestamp theTimestamp)

Parameters

Returns

public boolean equals (Object theObject)

Parameters

Returns

public boolean equals (Timestamp theTimestamp)

Parameters

Returns

public int getNanos ()

Returns

public long getTime ()

Returns

public void setNanos (int n)

Parameters

Throws

public void setTime (long theTime)

Parameters

public String toString ()

Returns

public static Timestamp valueOf (String s)

Parameters

Returns

Throws