org.postgresql.util

Class PGTime

java.lang.Object

java.util.Date

java.sql.Time

org.postgresql.util.PGTime

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Date>

public class PGTime
extends Time

This class augments the Java built-in Time to allow for explicit setting of the time zone.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
PGTime(long time) Constructs a PGTime without a time zone.
PGTime(long time, Calendar calendar) Constructs a PGTime with the given calendar object.

Method Summary

Modifier and Type	Method and Description
Object	clone() Return a copy of this object.
boolean	equals(Object obj) Compares two dates for equality.
Calendar	getCalendar() Returns the calendar object for this time.
int	hashCode() Returns a hash code value for this object.
void	setCalendar(Calendar calendar) Sets the calendar object for this time.

Methods inherited from class java.sql.Time

getDate, getDay, getMonth, getYear, setDate, setMonth, setTime, setYear, toInstant, toLocalTime, toString, valueOf, valueOf

Methods inherited from class java.util.Date

after, before, compareTo, from, getHours, getMinutes, getSeconds, getTime, getTimezoneOffset, parse, setHours, setMinutes, setSeconds, toGMTString, toLocaleString, UTC

Methods inherited from class java.lang.Object

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

Constructor Detail

PGTime

public PGTime(long time)

Constructs a PGTime without a time zone.

Parameters:

time - milliseconds since January 1, 1970, 00:00:00 GMT; a negative number is milliseconds before January 1, 1970, 00:00:00 GMT.

See Also:

Time.Time(long)

PGTime

public PGTime(long time,
              Calendar calendar)

Constructs a PGTime with the given calendar object. The calendar object is optional. If absent, the driver will treat the time as time without time zone. When present, the driver will treat the time as a time with time zone using the TimeZone in the calendar object. Furthermore, this calendar will be used instead of the calendar object passed to PreparedStatement.setTime(int, Time, Calendar).

Parameters:

time - milliseconds since January 1, 1970, 00:00:00 GMT; a negative number is milliseconds before January 1, 1970, 00:00:00 GMT.

calendar - the calendar object containing the time zone or null.

See Also:

Time.Time(long)

Method Detail

setCalendar

public void setCalendar(Calendar calendar)

Sets the calendar object for this time.

Parameters:

calendar - the calendar object or null.

getCalendar

public Calendar getCalendar()

Returns the calendar object for this time.

Returns:

the calendar or null.

hashCode

public int hashCode()

Description copied from class: java.util.Date

Returns a hash code value for this object. The result is the exclusive OR of the two halves of the primitive long value returned by the Date.getTime() method. That is, the hash code is the value of the expression:

 (int)(this.getTime()^(this.getTime() >>> 32))
 

Overrides:

hashCode in class Date

Returns:

a hash code value for this object.

See Also:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

equals

public boolean equals(Object obj)

Description copied from class: java.util.Date

Compares two dates for equality. The result is true if and only if the argument is not null and is a Date object that represents the same point in time, to the millisecond, as this object.

Thus, two Date objects are equal if and only if the getTime method returns the same long value for both.

Overrides:

equals in class Date

Parameters:

obj - the object to compare with.

Returns:

true if the objects are the same; false otherwise.

See Also:

Date.getTime()

clone

public Object clone()

Description copied from class: java.util.Date

Return a copy of this object.

Overrides:

clone in class Date

Returns:

a clone of this instance.

See Also:

Cloneable