org.tentackle.common

Class Time

java.lang.Object

java.util.Date

java.sql.Time

org.tentackle.common.Time

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Date>, Freezable

public class Time
extends Time
implements Freezable

Time with database semantics.

Differs from java.sql.Time when serialized/deserialized in different timezones. Databases don't provide a date and no timezone for a time, i.e. when sent over wire to different locations a time should always remain the same for all timezones. In java.sql.Time, however, the epochal time is serialized which may lead to a different time when deserialized in another timezone. In Time the effective date is serialized as HHMMSSmmm to provide the same semantics as databases do.

Furthermore, tentackle times can be frozen, i.e. made immutable.

Author:

harald

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Time() Creates the current time.
Time(long time) Constructs a Time object using a milliseconds time value.

Method Summary

Modifier and Type	Method and Description
Time	clone()
static Time	createFrozen(long epoch) Creates a frozen time.
void	freeze() Makes this object immutable.
Calendar	getCalendar() Gets the calendar for this date.
void	setDate(int date)
void	setHours(int hours)
void	setMinutes(int minutes)
void	setMonth(int month)
void	setSeconds(int seconds)
void	setTime(long time)
void	setYear(int year)

Methods inherited from class java.sql.Time

getDate, getDay, getMonth, getYear, toInstant, toLocalTime, toString, valueOf, valueOf

Methods inherited from class java.util.Date

after, before, compareTo, equals, from, getHours, getMinutes, getSeconds, getTime, getTimezoneOffset, hashCode, parse, toGMTString, toLocaleString, UTC

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.tentackle.common.Freezable

freeze

Constructor Detail

Time

public Time(long time)

Constructs a Time object using a milliseconds time value.

Parameters:

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

Time

public Time()

Creates the current time.

Method Detail

createFrozen

public static Time createFrozen(long epoch)

Creates a frozen time.

Parameters:

epoch - epochal milliseconds since January 1, 1970, 00:00:00 GMT

Returns:

the frozen time

clone

public Time clone()

Cloned times are always not frozen.

Overrides:

clone in class Date

getCalendar

public Calendar getCalendar()

Gets the calendar for this date.

Returns:

the calendar

freeze

public void freeze()

Description copied from interface: Freezable

Makes this object immutable.

Specified by:

freeze in interface Freezable

setTime

public void setTime(long time)

Overridden to clear the lazy calendar and check for frozen.

Overrides:

setTime in class Time

setYear

public void setYear(int year)

Overrides:

setYear in class Time

setMonth

public void setMonth(int month)

Overrides:

setMonth in class Time

setDate

public void setDate(int date)

Overrides:

setDate in class Time

setHours

public void setHours(int hours)

Overrides:

setHours in class Date

setMinutes

public void setMinutes(int minutes)

Overrides:

setMinutes in class Date

setSeconds

public void setSeconds(int seconds)

Overrides:

setSeconds in class Date