xal.ca

Class Timestamp

java.lang.Object

xal.ca.Timestamp

All Implemented Interfaces:

java.lang.Comparable<Timestamp>

public class Timestamp
extends java.lang.Object
implements java.lang.Comparable<Timestamp>

Timestamp

Field Summary

Fields

Modifier and Type	Field and Description
protected java.math.BigDecimal	_timestamp the timestamp information

Constructor Summary

Constructors

Constructor and Description
Timestamp(java.math.BigDecimal timestamp) Primary constructor from the full precision seconds since the Java epoch.
Timestamp(java.sql.Timestamp timestamp) Construct a Timestamp from a java.sql.Timestamp

Method Summary

Modifier and Type	Method and Description
int	compareTo(Timestamp otherTimestamp) Compare this timestamp with another timestamp.
boolean	equals(java.lang.Object timestamp) Determine if the specified timestamp equals this one.
java.util.Date	getDate() Get the times tamp as a Java Date.
java.math.BigDecimal	getFullSeconds() Get the time in seconds with full precision since the Java epoch.
double	getSeconds() Get the time in seconds since the Java epoch.
java.sql.Timestamp	getSQLTimestamp() Get the SQL Timestamp equivalent of this instance.
long	getTime() Get the timestamp in milliseconds relative to the Java epoch.
int	hashCode() Override the hashcode as required when overriding equals.
java.lang.String	toString() Get a string representation of the Timestamp.
java.lang.String	toString(java.text.DateFormat timeFormat) Generate a string representation of this timestamp using the specified time format for the time format up to seconds.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

_timestamp

protected java.math.BigDecimal _timestamp

the timestamp information

Constructor Detail

Timestamp

public Timestamp(java.math.BigDecimal timestamp)

Primary constructor from the full precision seconds since the Java epoch.

Parameters:

timestamp - the number of seconds since the Java epoch

Timestamp

public Timestamp(java.sql.Timestamp timestamp)

Construct a Timestamp from a java.sql.Timestamp

Parameters:

timestamp - an SQL timestamp

Method Detail

getDate

public java.util.Date getDate()

Get the times tamp as a Java Date. Some precision is lost since the Date class only supports millisecond resolution.

Returns:

The time stamp as a Date.

getTime

public long getTime()

Get the timestamp in milliseconds relative to the Java epoch.

Returns:

The time in milliseconds since the Java epoch.

getSeconds

public double getSeconds()

Get the time in seconds since the Java epoch.

Returns:

the time in seconds since the Java epoch.

getFullSeconds

public java.math.BigDecimal getFullSeconds()

Get the time in seconds with full precision since the Java epoch.

Returns:

the time in seconds since the Java epoch.

getSQLTimestamp

public java.sql.Timestamp getSQLTimestamp()

Get the SQL Timestamp equivalent of this instance.

Returns:

the SQL Timestamp equivalent of this instance.

toString

public java.lang.String toString(java.text.DateFormat timeFormat)

Generate a string representation of this timestamp using the specified time format for the time format up to seconds. Subsecond time is appended using a decimal point.

Parameters:

timeFormat - format for which to generate the string

Returns:

formatted string representation

toString

public java.lang.String toString()

Get a string representation of the Timestamp.

Overrides:

toString in class java.lang.Object

Returns:

a string representation of the Timestamp

equals

public boolean equals(java.lang.Object timestamp)

Determine if the specified timestamp equals this one.

Overrides:

equals in class java.lang.Object

Returns:

true if they are equals and false if not

hashCode

public int hashCode()

Override the hashcode as required when overriding equals. Equality implies equality of the underlying _timestamp instance variables.

Overrides:

hashCode in class java.lang.Object

compareTo

public int compareTo(Timestamp otherTimestamp)

Compare this timestamp with another timestamp.

Specified by:

compareTo in interface java.lang.Comparable<Timestamp>

Parameters:

otherTimestamp - The timestamp with which to compare this one

Returns:

0 if the timestamps are the same, negative if this is earlier than the supplied one and positive otherwise