oracle.adfnmc.java.sql
Class Timestamp

java.lang.Object
  java.util.Date
      oracle.adfnmc.java.sql.Timestamp

All Implemented Interfaces:

Comparable

Direct Known Subclasses:

Timestamp

public class Timestamp
extends java.util.Date
implements Comparable

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.

Field Summary

static java.lang.Class	CLASS_INSTANCE
static java.lang.String	CLASS_INSTANCE_NAME

Constructor Summary

Timestamp(long theTime)
Returns a Timestamp object corresponding to the time represented by a supplied time value.

Method Summary

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(java.util.Date theObject) Compares this Timestamp object with a supplied Timestamp object
int	compareTo(java.lang.Object another) Answers an integer indicating the relative positions of the receiver and the argument in the natural order of elements of the receiver's class.
int	compareTo(Timestamp theTimestamp) Compares this Timestamp object with a supplied Timestamp object
boolean	equals(java.lang.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)
java.lang.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(java.lang.String input) 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"

Methods inherited from class java.util.Date

hashCode

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

CLASS_INSTANCE

public static final java.lang.Class CLASS_INSTANCE

CLASS_INSTANCE_NAME

public static final java.lang.String CLASS_INSTANCE_NAME

Constructor Detail

Timestamp

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)

Method Detail

after

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

before

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

compareTo

public int compareTo(java.util.Date theObject)
              throws java.lang.ClassCastException

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:

java.lang.ClassCastException - if the supplied object is not a Timestamp object

compareTo

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

equals

public boolean equals(java.lang.Object theObject)

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

Overrides:

equals in class java.util.Date

Parameters:

theObject -

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

equals

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

getNanos

public int getNanos()

Gets this Timestamp's nanosecond value

Returns:

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

getTime

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)

Overrides:

getTime in class java.util.Date

setNanos

public void setNanos(int n)
              throws java.lang.IllegalArgumentException

Sets the nanosecond value for this timestamp

Throws:

java.lang.IllegalArgumentException

setTime

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)

Overrides:

setTime in class java.util.Date

toString

public java.lang.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"

Overrides:

toString in class java.util.Date

Returns:

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

valueOf

public static Timestamp valueOf(java.lang.String input)
                         throws java.lang.IllegalArgumentException

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:

java.lang.IllegalArgumentException

compareTo

public int compareTo(java.lang.Object another)

Description copied from interface: Comparable

Answers an integer indicating the relative positions of the receiver and the argument in the natural order of elements of the receiver's class.

Specified by:

compareTo in interface Comparable

Parameters:

another - Object an object to compare the receiver to

Returns:

int which should be <0 if the receiver should sort before the argument, 0 if the receiver should sort in the same position as the argument, and >0 if the receiver should sort after the argument.